error.Is 用于判断错误链中是否包含指定目标错误值,通过逐层调用 Unwrap() 并用 == 比较各层错误值实现;需传入哨兵错误变量,不可传类型或临时错误实例。

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 变量):
立即学习“go语言免费学习笔记(深入)”;
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) { ... }。










