Go中errors.Is判断错误类型方法

Go 1.13 引入的 `errors.Is` 是判断错误语义相等性的官方标准方式——它不依赖易变的错误文本，也不受限于指针是否相同，而是通过安全穿透 `%w` 包装链、调用自定义 `Is` 方法或比对导出的错误变量（如 `os.ErrNotExist`）来精准识别“是不是这个错误”，帮你告别 `err == io.EOF` 失败的困惑、避免字符串匹配的脆弱陷阱，并真正实现可维护、可扩展、跨包装层的错误分类逻辑。

怎么用 errors.Is 判断是否是某个具体错误

errors.Is 是 Go 1.13 引入的官方推荐方式，用来判断一个 error 是否「等于」或「包装了」某个目标错误（比如 io.EOF、自定义错误变量等）。它比直接用 == 更安全，能穿透 fmt.Errorf("...: %w", err) 的包装链。

常见错误现象：用 err == io.EOF 判断失败，但实际错误就是 EOF —— 因为被 %w 包装过，原始指针已丢失。

• 必须传入一个「错误值」（不是类型），通常是包里导出的变量，如 sql.ErrNoRows、os.ErrNotExist
• 不能传类型（比如 errors.Is(err, *os.PathError{})）—— 编译不过，也不符合设计意图
• 如果目标错误是自定义的，建议定义为变量（var ErrNotFound = errors.New("not found")），而不是每次 errors.New 新建
• 示例：

  if errors.Is(err, os.ErrNotExist) {
      // 处理文件不存在
  }

errors.As 和 errors.Is 到底该用哪个

errors.Is 解决「是不是这个错误」，errors.As 解决「能不能转成这个类型并取出来」。两者用途不同，别混用。

典型误用场景：想获取底层 *os.PathError 的 Path 字段，却写了 errors.Is(err, &os.PathError{}) —— 这既不合法也不达目的。

• 要用字段或方法？选 errors.As：

  var pathErr *os.PathError
  if errors.As(err, &pathErr) {
      log.Println("failed on path:", pathErr.Path)
  }

• 只关心“是不是某类语义错误”（比如重试、取消、超时）？选 errors.Is
• errors.As 要求第二个参数是指向接口或指针类型的地址，且目标类型需实现 error 接口
• 性能上两者都极轻量，无明显差异；但 As 多一次类型断言开销，不过可忽略

自定义错误怎么配合 errors.Is 正确工作

如果你自己实现了 error 接口，又希望别人能用 errors.Is(err, MyErr) 匹配到，关键点只有一个：实现 Is 方法。

没实现 Is 方法时，errors.Is 只会做最基础的指针/值相等判断，无法穿透包装或识别逻辑相等。

• 最简正确定义：

  var ErrTimeout = errors.New("timeout")
  
  type timeoutError struct{}
  
  func (timeoutError) Error() string { return "timeout" }
  func (timeoutError) Is(target error) bool {
      return target == ErrTimeout // 或其他你认为“相等”的逻辑
  }

• 更常见的做法是复用已有变量，避免重复构造：return errors.Is(target, ErrTimeout)
• 注意：不要在 Is 方法里写可能 panic 的逻辑（比如解引用 nil），errors.Is 会递归调用它
• 如果错误带状态（比如含 code 字段），Is 方法可以按需扩展判断逻辑，不只是硬比较

为什么 errors.Is 有时返回 false，明明错误信息一模一样

因为 errors.Is 不看错误文本，只看错误值本身或其 Is 方法返回结果。字符串相同 ≠ 错误相等。

典型陷阱：两个 errors.New("not found") 创建的 error 值互不相等，即使内容完全一致。

• 永远不要靠 err.Error() 做错误分类 —— 文本易变、不可靠、国际化后更糟
• 所有需要被 Is 匹配的错误，必须来自同一变量或明确复用的实例
• 第三方库若没导出错误变量（比如只返回 fmt.Errorf），你就无法用 Is 稳定匹配 —— 这时只能退回到 errors.As 或检查底层类型
• 调试时可用 fmt.Printf("%#v", err) 看实际类型和结构，比读日志更准

事情说清了就结束。真正难的不是调用 errors.Is，而是从一开始就把错误当作可识别、可传递、有边界的值来设计，而不是拼字符串或临时造错误。

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