Golangerrors包常用方法全解析

本文深入解析了 Golang 中 errors 包的常用方法，助力开发者构建更健壮的程序。文章详细讲解了如何使用 `errors.New()` 和 `fmt.Errorf()` 创建自定义错误，并推荐使用 `errors.Is()` 进行错误比较，尤其是在处理包装过的错误时。此外，文章还介绍了 `errors.As()` 的使用，帮助开发者从错误链中提取特定类型的错误。最后，文章阐述了错误包装机制，并通过实例展示了如何使用 `%w` 格式符包装错误，以及如何利用 `errors.Unwrap()` 解包错误。掌握这些关键方法，开发者可以更高效地处理 Golang 中的各种错误场景。

在 Go 语言中，错误处理通过 errors 包实现，主要包括创建、比较、提取和包装错误。1. 创建错误使用 errors.New() 或 fmt.Errorf()，前者适用于固定信息，后者用于动态拼接；2. 错误比较推荐使用 errors.Is()，它支持递归检查错误链，也可用 == 比较简单判断；3. 提取特定类型错误使用 errors.As()，可在错误链中查找目标类型；4. 错误包装通过 fmt.Errorf 结合 %w 实现，保留原始错误信息，可用 errors.Unwrap() 手动解包，但更推荐直接配合 errors.Is() 或 errors.As() 使用。

在 Go 语言中，错误处理是一个非常核心的部分。标准库中的 errors 包虽然简单，但却是构建健壮程序的基础工具之一。它提供了一些基础功能来创建和比较错误。

创建自定义错误：使用 errors.New() 和 fmt.Errorf

最常用的两种方式是通过 errors.New() 或者 fmt.Errorf() 来生成错误：

• errors.New("your error message")
  这是最直接的方式，适合不需要格式化信息的场景。例如：

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

• fmt.Errorf("error occurred: %v", err)
  更加灵活，可以插入变量或拼接信息。注意，在 Go 1.13+ 中推荐加上 %w 动词用于包装错误（后面会提到）：

  

  err := fmt.Errorf("failed to read file: %w", os.ErrNotExist)

如果你只是想返回一个固定的错误字符串，用 errors.New 就够了；需要动态拼接时，优先考虑 fmt.Errorf。

错误比较：errors.Is() 和 ==

当我们需要判断某个错误是否是我们期望的那个时，可以用到以下方法：

• == 比较
  直接比较两个错误是否相同。适用于简单的预定义错误，比如：

  if err == os.ErrNotExist {
      // 处理文件不存在的情况
  }

• errors.Is(err, target)
  这是更推荐的做法，尤其当你处理的是被包装过的错误（wrap）。这个函数会递归地检查错误链，直到找到匹配的目标错误为止。

注意：如果错误是用 fmt.Errorf(...%w...) 包装过的，必须用 errors.Is() 才能正确识别原始错误。

获取底层错误：errors.As()

有时候我们需要从一个可能被包装过的错误中提取特定类型的错误。这时候就要用到 errors.As()：

var pathErr *fs.PathError
if errors.As(err, &pathErr) {
    fmt.Println("File path error:", pathErr.Path)
}

这段代码的意思是：尝试将 err 转换为 *fs.PathError 类型，并获取其中的信息。

• errors.As() 会在错误链中查找是否有目标类型的错误。
• 与类型断言不同，它不会因为中间层错误而失败。

使用场景举例：你调用了某个库的方法，它返回了一个封装后的错误，你想从中提取出具体的系统错误类型进行处理。

错误包装（Wrap）和 Unwrap

Go 1.13 引入了错误包装机制，使得你可以把一个错误包进另一个里面，同时保留原始错误信息。

• 使用 %w 格式符包装错误

  err := fmt.Errorf("read failed: %w", io.ErrUnexpectedEOF)

• 解包错误：errors.Unwrap() 可以手动解开一层包装，拿到里面的错误：

  cause := errors.Unwrap(err)

不过大多数情况下你并不需要自己去一层层拆包，而是直接用前面提到的 errors.Is() 或 errors.As() 来处理。

基本上就这些。Go 的 errors 包设计得简洁但实用，掌握这几个关键方法，就能应对大多数错误处理场景了。

好了，本文到此结束，带大家了解了《Golangerrors包常用方法全解析》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！