使用 %w 包装错误可保留原始错误并添加上下文,便于通过 Errors.Is 和 errors.As 判断或提取底层错误,应避免无意义的重复包装,确保每层提供有效上下文信息。
在 Go 1.13 之后,fmt.Errorf 支持通过 %w 动词来包装错误,实现嵌套错误的链式处理。这种方式既能保留原始错误信息,又能添加上下文,便于调试和错误溯源。
使用 %w 包装错误
当你需要在不丢失原始错误的前提下添加上下文时,使用 %w 是最佳实践:
if err := readFile(name); err != nil {
return fmt.Errorf(“failed to read config file %q: %w”, name, err)
}
这样返回的错误保留了底层错误,可以通过 errors.Is 和 errors.As 进行判断和解包。
判断和提取原始错误
使用 errors.Is 判断错误链中是否包含特定错误:
立即学习“go语言免费学习笔记(深入)”;
if errors.Is(err, os.ErrNotExist) {
log.Println(“config file does not exist”)
}
使用 errors.As 提取特定类型的错误以便访问其字段或方法:
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.printf(“Filesystem error on path: %s”, pathErr.Path)
}
避免过度包装
只在需要添加有意义上下文时才使用 %w。如果只是透传错误,直接返回即可:
// 不要这样:
// return fmt.Errorf(“read failed: %w”, err)
// 更好:
// return err
重复包装会让错误链变得冗长,增加排查难度。确保每一层包装都提供新的上下文信息,比如操作、参数或阶段。
基本上就这些。合理使用 fmt.Errorf 配合 %w,能让错误处理更清晰、可追溯,同时保持代码简洁。
评论(已关闭)
评论已关闭