Go错误处理通过函数返回error值而非try-catch,强调错误是普通值、出错是常态;标准写法为最后返回error,调用时须用if err != nil检查,推荐用%w包装错误并用errors.Is/As判断,可自定义error类型添加上下文。

Go 语言的错误处理不依赖 try-catch,而是通过函数显式返回 error 类型值,并由调用方主动检查。这是 Go 的核心设计哲学:错误是普通值,不是异常;出错是常态,不是意外。
函数返回 error 的标准写法
Go 中约定俗成的错误返回模式是:最后一个返回值为 error 类型。如果操作成功,返回 nil;失败则返回具体错误(如 fmt.Errorf、errors.New 或系统错误)。
例如:
func divide(a, b float64) (float64, error) {
if b == 0 {
return 0, fmt.Errorf("division by zero")
}
return a / b, nil
}
调用时必须检查 error:
立即学习“go语言免费学习笔记(深入)”;
result, err := divide(10, 0)
if err != nil {
log.Printf("计算失败:%v", err)
return
}
fmt.Println("结果:", result)
判断 error 是否发生:永远先检查 err != nil
Go 不会自动中断执行,也不抛出异常。一旦忽略 err,程序可能继续用无效数据运行,导致更隐蔽的问题。
- 不要只写
if err { ... }——error是接口类型,不能直接布尔判断 - 正确写法始终是
if err != nil { ... } - 常见误写:
if err == nil { ... } else { ... }—— 可读性差,建议把错误处理提前(“fail fast”)
创建和包装错误的常用方式
Go 1.13+ 推荐使用 fmt.Errorf 配合 %w 动词包装底层错误,便于后续用 errors.Is 或 errors.As 判断:
// 包装错误(保留原始错误链)
err := fmt.Errorf("reading config: %w", os.OpenError)
// 检查是否是特定错误
if errors.Is(err, os.ErrNotExist) {
log.Println("配置文件不存在,使用默认配置")
}
// 提取底层错误类型
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Printf("路径错误:%s", pathErr.Path)
}
自定义错误类型(可选但推荐用于关键逻辑)
当需要携带额外上下文(如错误码、请求 ID、重试次数),可实现 error 接口:
type MyError struct {
Code int
Msg string
ReqID string
}
func (e *MyError) Error() string {
return fmt.Sprintf("[%d] %s (req=%s)", e.Code, e.Msg, e.ReqID)
}
// 使用
return nil, &MyError{Code: 400, Msg: "invalid input", ReqID: r.Header.Get("X-Request-ID")}
这样既保持兼容性,又支持结构化错误处理和日志追踪。










