Golang errors包常用方法：New、Wrap与Unwrap详解

Go 1.13起errors包支持错误包装，New创建基础错误，Wrap（来自pkg/errors）添加上下文并保留原错误，Unwrap解析错误链，结合Is、As可遍历判断，建议用fmt.Errorf搭配%w实现标准错误包装，提升错误追踪与维护性。

在 Go 语言中，错误处理是程序设计的重要组成部分。虽然 Go 1.13 之前的标准库 errors 包功能较为基础，但从 Go 1.13 开始引入了对错误包装（wrapping）的支持，使得错误链的构建和解析成为可能。本文将详细讲解 errors 包中常用的三个方法：New、Wrap 和 Unwrap，并说明它们的使用场景和注意事项。

New：创建基础错误

errors.New 是最基础的错误创建方式，用于生成一个简单的、不可包装的错误值。

它接收一个字符串，返回一个实现了 error 接口的类型。

示例：

err := errors.New("something went wrong")

这个错误只是一个纯文本信息，不包含堆栈信息，也无法携带底层错误。适用于不需要上下文或嵌套错误的场景。

注意：使用 errors.New 创建的错误无法被 Wrap，因为它不支持错误包装机制。

Wrap：包装错误，保留上下文

虽然标准库 errors 包本身没有提供 Wrap 方法，但社区广泛使用的 github.com/pkg/errors 包提供了这一功能。它是实际开发中处理错误链的常用工具。

errors.Wrap 的作用是将一个已有错误包装起来，附加额外的上下文信息（如当前操作的描述），同时保留原始错误，形成错误链。

示例：

if err != nil {
  return errors.Wrap(err, "failed to read config file")
}

这样，当错误最终被打印时，可以通过 errors.Cause 或 %+v 格式获取完整的错误链和堆栈信息。

使用 Wrap 能帮助开发者定位错误源头，尤其在多层调用中非常有用。

Unwrap：提取被包装的错误

Go 1.13+ 在标准库 errors 包中引入了 Unwrap 函数，用于从包装错误中提取出底层错误。

如果一个错误实现了 Unwrap() error 方法，那么它就是一个可展开的包装错误。

示例：

if err != nil {
  wrappedErr := fmt.Errorf("operation failed: %w", err)
}

这里使用了 %w 动词来创建一个可展开的错误。之后可以使用 errors.Unwrap 获取原始错误：

original := errors.Unwrap(wrappedErr)

还可以使用 errors.Is 和 errors.As 遍历整个错误链，判断是否包含某个特定错误或是否能转换为某个类型。

例如：

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

总结与建议

标准库 errors 提供了基础的错误创建和解析能力，而 github.com/pkg/errors 则增强了错误包装和堆栈追踪功能。

在现代 Go 项目中：

• 用 errors.New 创建简单错误
• 用 fmt.Errorf + %w 实现标准库兼容的错误包装
• 用 errors.Unwrap、errors.Is、errors.As 进行错误判断和提取
• 若需堆栈信息，可引入 pkg/errors，但注意与标准库的兼容性

基本上就这些。掌握这些方法，能让你的 Go 错误处理更清晰、更可维护。