Golang错误处理技巧与实践

Go 1.13 引入的错误包装机制通过 `fmt.Errorf` 的 `%w` 动词、`errors.Unwrap`、`errors.Is` 和 `errors.As` 构建了一套强大而简洁的错误处理范式——它既能在多层调用中逐级添加有意义的上下文，又完整保留原始错误信息，让开发者既能清晰追踪错误发生路径，又能精准判断类型、提取细节并做出差异化响应；掌握这一现代 Go 错误处理核心实践，是编写健壮、可维护、易调试服务的关键一步。

在Go语言中，错误包装（Error Wrapping）是一种将底层错误信息保留并附加更多上下文的方式，使得调用者既能知道发生了什么，也能了解错误发生的路径。从Go 1.13开始，标准库引入了对错误包装的支持，主要通过 fmt.Errorf 配合 %w 动词来实现。

使用 fmt.Errorf 和 %w 进行错误包装

当你需要在原有错误基础上添加上下文时，可以使用 fmt.Errorf 并配合 %w 动词来包装错误。

例如：

if err != nil {
    return fmt.Errorf("failed to read config file: %w", err)
}

这里的 %w 表示将原始错误包装进去。这样返回的错误就包含了原始错误，并可以通过 errors.Unwrap 提取。

提取和检查包装的错误

要判断一个错误是否是由特定类型引起的，即使它被包装了多次，可以使用 errors.Is 和 errors.As。

• errors.Is(err, target)：判断错误链中是否有某个特定错误（比如 os.ErrNotExist）。
• errors.As(err, &target)：判断错误链中是否包含某个特定类型的错误，可用于提取具体错误值。

示例：

if errors.Is(err, os.ErrNotExist) {
    log.Println("file does not exist")
}

var pathErr *os.PathError
if errors.As(err, &pathErr) {
    log.Printf("path error: %v", pathErr.Path)
}

多层包装与错误链

错误可以被多次包装，形成一条“错误链”。每一层都可以添加上下文，而原始错误仍然可访问。

例如：

func readFile(path string) error {
    data, err := os.ReadFile(path)
    if err != nil {
        return fmt.Errorf("reading %s: %w", path, err)
    }
    // 处理数据...
    return process(data)
}

func process(data []byte) error {
    // 模拟处理失败
    return fmt.Errorf("processing failed: %w", io.ErrUnexpectedEOF)
}

最终的错误信息会显示完整的上下文路径，同时保留原始错误，便于调试和处理。

基本上就这些。使用 %w 包装、Is 判断等价性、As 提取具体类型，是现代Go错误处理的标准做法。注意不要滥用包装，避免重复添加无意义的上下文。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~