Golangerror.Is用法详解

`errors.Is` 是 Go 1.13 引入的核心错误处理工具，专用于精准判断一个错误链中是否**包含某个特定的哨兵错误值**（如 `io.EOF` 或自定义 `var ErrNotFound = errors.New("not found")`），它通过逐层调用 `Unwrap()` 并用 `==` 比较各层错误值实现，强调“值相等”而非“类型匹配”——这意味着你必须传入已定义的错误变量，绝不能传类型、指针字面量或临时 `fmt.Errorf`；它与 `errors.As` 各司其职：前者快速确认“是不是这个错”，后者深入提取“错的类型和上下文”，二者协同可构建健壮、可读、可维护的错误处理逻辑，是现代 Go 工程中不可或缺的错误诊断利器。

error.Is 是 Go 1.13 引入的错误处理工具函数，用于判断一个错误链中是否**包含某个目标错误值（value）**，即是否与目标错误相等（==）。它适用于需要检查是否发生了某个特定错误（比如 io.EOF、os.ErrNotExist 或自定义的哨兵错误）的场景。

核心原理：逐层展开错误链并用 == 比较

error.Is(err, target) 会沿着 err 的错误链（通过 Unwrap() 方法）向上遍历，对每个错误值（包括 err 本身）执行 == 判断，只要任一环节满足 errX == target 就返回 true。

注意：它比对的是错误值（value），不是类型（type）。因此目标 target 必须是一个变量或常量（如哨兵错误），不能是类型（如 *os.PathError）。

正确用法：传入哨兵错误或已知错误实例

✅ 推荐方式：使用标准库或自定义的哨兵错误（var 变量）：

• if errors.Is(err, io.EOF) { ... }
• if errors.Is(err, os.ErrNotExist) { ... }
• var ErrValidationFailed = errors.New("validation failed")
if errors.Is(err, ErrValidationFailed) { ... }

⚠️ 错误方式：传入类型、指针字面量或临时构造的错误：

• errors.Is(err, &os.PathError{}) ❌（每次新建对象，地址不同）
• errors.Is(err, (*os.PathError)(nil)) ❌（nil 指针无法 == 比较）
• errors.Is(err, fmt.Errorf("xxx")) ❌（每次 new，值不等）

与 error.As 的区别：值 vs 类型

error.Is 关注“是不是这个错误”，而 error.As 关注“能不能转成这个类型”：

• errors.Is(err, os.ErrNotExist) → 判断是否等于那个特定错误值
• var pathErr *os.PathError; errors.As(err, &pathErr) → 判断错误链中是否有 *os.PathError 类型的实例，并提取出来

二者常配合使用：先用 Is 做快速哨兵匹配，再用 As 提取上下文信息（如路径、操作名）。

注意事项和常见陷阱

? 自定义错误若要支持 Is，需实现 Unwrap() error 方法返回下层错误（否则只比较自身）；
? 如果错误实现了 Is(error) bool 方法（Go 1.20+ 支持），errors.Is 会优先调用该方法，可用于更灵活的语义匹配；
? 不要对 nil 错误调用 errors.Is(nil, someErr) —— 它会返回 false（因为 nil == someErr 为假）；
? 多个哨兵可链式判断：if errors.Is(err, os.ErrNotExist) || errors.Is(err, os.ErrPermission) { ... }。

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