errors.Is用于判断错误是否与目标错误相等,可递归解包错误。例如os.Open返回的错误可用errors.Is(err, os.ErrNotExist)判断文件不存在,支持自定义哨兵错误和%w包装,比errors.As更适用于具体错误值的比较,提升错误处理安全性与可读性。

在Go语言中,处理错误时经常需要判断一个错误是否是特定类型的错误。从Go 1.13开始,errors.Is 函数被引入,提供了一种更清晰、安全的方式来比较错误,尤其适用于带有错误包装(error wrapping)的场景。
errors.Is 的基本用法
errors.Is 函数用于判断一个错误是否与另一个目标错误相等,它会递归地解包被包装的错误,直到找到匹配的目标错误或无法再解包为止。
函数签名如下:
func Is(err, target error) bool如果 err 和 target 表示相同的错误,或者 err 是由 target 包装而来,就返回 true。
立即学习“go语言免费学习笔记(深入)”;
示例:
package mainimport (
"errors"
"fmt"
"os"
)
func main() {
_, err := os.Open("non-existent-file.txt")
if errors.Is(err, os.ErrNotExist) {
fmt.Println("文件不存在")
} else if err != nil {
fmt.Println("其他错误:", err)
}
}
在这个例子中,即使 os.Open 返回的错误被中间层包装过,errors.Is 依然能正确识别出它是否源自 os.ErrNotExist。
自定义错误与 errors.Is
你也可以在自己的代码中定义哨兵错误(sentinel errors),并使用 errors.Is 进行判断。
var ErrValidationFailed = errors.New("验证失败")func validate(input string) error {
if input == "" {
return fmt.Errorf("输入为空: %w", ErrValidationFailed)
}
return nil
}
func main() {
err := validate("")
if errors.Is(err, ErrValidationFailed) {
fmt.Println("验证出错")
}
}
使用 %w 格式动词包装错误后,errors.Is 能穿透包装,正确匹配到原始的 ErrValidationFailed 错误。
对比 errors.Is 与 errors.As
errors.Is 用于判断是否是某个具体错误值,而 errors.As 用于判断错误链中是否包含某个类型的错误(比如自定义结构体错误)。
例如:
if errors.Is(err, os.ErrNotExist) { ... } // 判断是否是某个错误值var pathErr *os.PathError
if errors.As(err, &pathErr) { ... } // 判断是否可以解包为 *os.PathError 类型
两者用途不同,应根据场景选择。
基本上就这些。使用 errors.Is 能让错误判断更安全、可读性更强,尤其是在多层包装的错误处理中,推荐优先使用。不复杂但容易忽略。










