使用errors.Is可判断错误是否与目标相等,它能递归检查包装后的底层错误。例如用fmt.Errorf("%w", err)包装时,errors.Is仍能识别原始错误,而直接==比较则无法做到。应优先使用errors.Is进行语义化错误判断,特别是在错误被多层包装或需匹配预定义错误(如os.ErrNotExist)时,确保错误处理更健壮可靠。

在Golang中,判断错误类型是日常开发中的常见需求。从Go 1.13开始,标准库引入了errors.Is和errors.As,让错误判断更加清晰、安全。本文重点讲解如何使用errors.Is来判断两个错误是否相等,即是否表示同一种错误。
什么是errors.Is
errors.Is(err, target)用于判断err是否与target错误相等。它不仅仅比较错误的值,还支持递归地检查错误链中的底层错误(通过Unwrap方法),因此适用于包装过的错误场景。
简单来说:当你使用fmt.Errorf("wrap: %w", err)包装一个错误时,原始错误仍然可以通过errors.Is被识别出来。
基本用法示例
假设我们定义了一个预定义错误:
立即学习“go语言免费学习笔记(深入)”;
var ErrNotFound = errors.New("not found")
func findUser(id int) (string, error) {
if id != 1 {
return "", fmt.Errorf("user %d: %w", id, ErrNotFound)
}
return "Alice", nil
}
调用后判断错误类型:
user, err := findUser(2)
if err != nil {
if errors.Is(err, ErrNotFound) {
fmt.Println("用户不存在")
} else {
fmt.Println("其他错误:", err)
}
}
尽管err是被包装过的错误,errors.Is仍能正确识别出它是否源自ErrNotFound。
与==判断的区别
直接使用==只能判断两个错误变量是否指向同一个实例,无法处理包装场景:
-
err == ErrNotFound:仅当err就是ErrNotFound本身时才成立 -
errors.Is(err, ErrNotFound):即使err是fmt.Errorf("failed: %w", ErrNotFound)也能匹配成功
因此,在涉及错误包装的项目中,推荐始终使用errors.Is进行语义上的“错误相等”判断。
何时该用errors.Is
- 需要判断某个错误是否是特定预定义错误(如
os.ErrNotExist) - 错误经过多层函数传递并可能被包装
- 希望代码对错误的语义进行判断,而非具体类型或消息内容
例如标准库中常用模式:
if errors.Is(err, os.ErrNotExist) {
// 处理文件不存在
}
基本上就这些。合理使用errors.Is能让错误处理更健壮、可维护,避免因错误包装导致逻辑失效。关键是定义好你的公共错误变量,并在包装时使用%w动词。不复杂但容易忽略细节。










