17370845950

Go 1.13增强errors包，支持错误包装（%w）、errors.Is判断相等、errors.As提取类型，推荐底层返回具体错误、中间层添加上下文、顶层分类处理，提升错误可读性与维护性。

Go语言从1.13版本开始对 errors 包进行了增强，引入了错误包装（error wrapping）、错误判定和错误类型提取等功能，使错误处理更加灵活和语义化。合理使用 errors 包能提升程序的可维护性和调试效率。

错误包装：Wrap 和 Unwrap

在实际开发中，底层函数返回错误时，上层函数往往需要添加上下文信息以便于定位问题。Go 通过 %w 动词实现错误包装。

示例：

package main

import (
    "errors"
    "fmt"
)

func readFile() error {
    return fmt.Errorf("读取文件失败: %w", errors.New("文件不存在"))
}

func processFile() error {
    return fmt.Errorf("处理文件出错: %w", readFile())
}

func main() {
    err := processFile()
    fmt.Println(err) // 输出：处理文件出错: 读取文件失败: 文件不存在
}

判断错误是否相等：errors.Is

当需要判断某个错误链中是否包含特定错误时，使用 errors.Is 比 == 更安全，因为它会递归检查被包装的错误。

示例：

target := errors.New("连接超时")
err := fmt.Errorf("网络请求失败: %w", target)

if errors.Is(err, target) {
    fmt.Println("捕获到连接超时错误")
}

即使错误被多层包装，errors.Is 也能正确匹配目标错误。

提取特定类型的错误：errors.As

当错误链中可能包含自定义结构体错误时，可用 errors.As 提取对应类型的变量，便于访问其字段或方法。

示例：

type MyError struct {
    Code int
    Msg  string
}

func (e *MyError) Error() string {
    return fmt.Sprintf("错误码 %d: %s", e.Code, e.Msg)
}

func doSomething() error {
    return fmt.Errorf("操作失败: %w", &MyError{Code: 404, Msg: "未找到资源"})
}

func main() {
    err := doSomething()
    var myErr *MyError
    if errors.As(err, &myErr) {
        fmt.Printf("错误码: %d, 消息: %s\n", myErr.Code, myErr.Msg)
    }
}

这段代码成功从包装错误中提取出 *MyError 类型实例。

常见使用场景建议

在实际项目中，推荐以下做法：

• 底层函数返回具体错误（如 io.EOF、os.ErrNotExist）
• 中间层使用 fmt.Errorf(...%w) 添加上下文
• 顶层统一通过 errors.Is 或 errors.As 进行分类处理
• 避免重复包装同一错误
• 不要用 %w 包装 nil 错误，会导致 panic

基本上就这些。掌握 errors 包的核心功能后，可以写出更清晰、易调试的 Go 错误处理逻辑。关键是理解包装链的结构以及 Is/As 的递归查找机制。不复杂但容易忽略细节。