如何创建自定义错误 errors.New和fmt.Errorf用法-Golang-PHP中文网

如何创建自定义错误 errors.New和fmt.Errorf用法

P粉602998670

发布： 2025-09-04 08:38:01

原创

352人浏览过

errors.New用于创建固定错误信息，适合静态错误；2. fmt.Errorf支持格式化动态生成错误消息，更灵活；3. 使用%w可包装错误并保留原始错误，便于后续判断类型。

如何创建自定义错误 errors.new和fmt.errorf用法

在 Go 语言中，处理错误是程序设计的重要部分。除了使用标准库提供的错误外，我们经常需要创建自定义错误来更准确地描述问题。Go 提供了 errors.New 和 fmt.Errorf 两种常用方式来创建错误。下面详细介绍它们的用法和适用场景。

errors.New：创建简单的静态错误

当你只需要一个固定的错误消息时，errors.New 是最简单直接的方式。它返回一个实现了 error 接口的错误值。

示例：

eMart 网店系统

功能列表：底层程序与前台页面分离的效果，对页面的修改无需改动任何程序代码。完善的标签系统，支持自定义标签，公用标签，快捷标签，动态标签，静态标签等等，支持标签内的vbs语法，原则上运用这些标签可以制作出任何想要的页面效果。兼容原来的栏目系统，可以很方便的插入一个栏目或者一个栏目组到页面的任何位置。底层模版解析程序具有非常高的效率，稳定性和容错性，即使模版中有错误的标签也不会影响页面的显示。所有的标

查看详情

package main

import (
    "errors"
    "fmt"
)

func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("cannot divide by zero")
    }
    return a / b, nil
}

func main() {
    result, err := divide(10, 0)
    if err != nil {
        fmt.Println("Error:", err)
    } else {
        fmt.Println("Result:", result)
    }
}

登录后复制

输出：

Error: cannot divide by zero

登录后复制

这种写法适合错误信息固定、不需要动态参数的情况。

fmt.Errorf：格式化创建错误

当你需要根据上下文动态生成错误消息时，应使用 fmt.Errorf。它的用法类似于 fmt.Printf，支持格式化占位符。

示例：

func readFile(filename string) error {
    if filename == "" {
        return fmt.Errorf("invalid filename: %q is not allowed", filename)
    }
    // 模拟读取文件失败
    return fmt.Errorf("failed to open file: %s", filename)
}

func main() {
    err := readFile("")
    if err != nil {
        fmt.Println("Error:", err)
    }
}

登录后复制

输出：

Error: invalid filename: "" is not allowed

登录后复制

fmt.Errorf 更灵活，适合需要拼接变量或提供上下文信息的错误。

包装错误并保留原始错误信息

从 Go 1.13 开始，fmt.Errorf 支持通过 %w 动词来包装错误，这样可以保留原始错误，便于后续使用 errors.Is 或 errors.As 判断错误类型。

示例：

import (
    "errors"
    "fmt"
)

var ErrNotFound = errors.New("item not found")

func findItem(id int) (string, error) {
    if id < 0 {
        return "", fmt.Errorf("invalid ID: %d: %w", id, ErrNotFound)
    }
    return "item-data", nil
}

func main() {
    _, err := findItem(-1)
    if errors.Is(err, ErrNotFound) {
        fmt.Println("Item was not found")
    }
}

登录后复制

使用 %w 可以构建错误链，让调用方能追溯根本原因。

基本上就这些。简单错误用 errors.New，带变量的用 fmt.Errorf，需要错误链时记得用 %w 包装原始错误。不复杂但容易忽略细节。

以上就是如何创建自定义错误 errors.New和fmt.Errorf用法的详细内容，更多请关注php中文网其它相关文章！