Go错误处理通过显式返回error接口值实现,要求调用方主动检查;error是含Error()string方法的接口,常用errors.New或fmt.Errorf创建,函数按约定将error作为最后一个返回值,并需用errors.Is/As区分类型、合理处理异常。

在 Go 语言中,错误处理不是靠 try/catch,而是通过显式返回 error 类型值,并由调用方主动检查。这是 Go “明确优于隐式” 设计哲学的体现。
理解 error 是一个接口类型
Go 的 error 是一个内建接口:
Error() string
}
任何实现了 Error() 方法(返回 string)的类型,都可作为 error 使用。标准库中常用 errors.New() 或 fmt.Errorf() 创建错误值。
-
errors.New("file not found"):创建简单静态错误 -
fmt.Errorf("read %s: %w", filename, err):包装错误(Go 1.13+ 支持%w),保留原始错误链
函数应按约定返回 error 作为最后一个返回值
Go 社区广泛采用“多返回值 + 最后一个为 error”的模式。例如:
立即学习“go语言免费学习笔记(深入)”;
func readFile(filename string) ([]byte, error) {data, err := os.ReadFile(filename)
if err != nil {
return nil, fmt.Errorf("failed to read %s: %w", filename, err)
}
return data, nil
}
调用时必须检查:
if err != nil {
log.Fatal(err)
}
// 正常逻辑使用 data
区分错误类型与错误值,合理判断异常场景
不能只靠 err != nil 做统一处理,需结合业务判断是否可恢复、是否需重试、是否要忽略等:
- 用
errors.Is(err, fs.ErrNotExist)判断是否为“文件不存在”,适合做初始化兜底 - 用
errors.As(err, &pathErr)提取底层错误(如*os.PathError),获取路径、操作等细节 - 自定义错误类型可实现更精确控制,例如定义
ValidationError并在 HTTP handler 中返回 400
避免常见错误习惯
不忽略错误:即使只是 log.Printf,也要显式处理,禁用 _ = someFunc()。
不重复包装已包装的错误:避免 fmt.Errorf("xxx: %w", fmt.Errorf("yyy: %w", err)),会丢失中间信息。
不在错误消息中重复打印堆栈(除非调试需要):Go 错误本身不带栈,若需追踪,用 github.com/pkg/errors 或 Go 1.17+ 的 runtime/debug.PrintStack() 辅助定位。










