Go语言通过error接口实现显式错误处理,任何实现Error() string的类型均可作为错误;标准库提供errors.New和fmt.Errorf创建简单错误,自定义错误可携带错误码、时间等上下文信息;Go 1.13起支持用%w包装错误,结合errors.Is和errors.As实现链式判断与类型断言;建议根据场景选择简单错误、自定义类型或错误包装,保持错误处理清晰可控。

Go语言中的错误处理是通过返回值显式传递错误来实现的,核心机制依赖于内置的 error 接口。这个接口非常简单,只定义了一个方法:
type error interface { Error() string }任何实现了 Error() 方法的类型都可以作为错误使用。标准库中常见的 errors.New 和 fmt.Errorf 都返回一个实现了该接口的预定义类型。
基本用法:使用内置错误创建
对于简单场景,可以直接使用标准库提供的函数创建错误:
import "errors" func divide(a, b float64) (float64, error) { if b == 0 { return 0, errors.New("cannot divide by zero") } return a / b, nil }或者使用 fmt.Errorf 添加格式化信息:
立即学习“go语言免费学习笔记(深入)”;
if b == 0 { return 0, fmt.Errorf("division failed: divisor %.2f is invalid", b) }自定义错误类型:携带更多上下文
当需要传递错误的具体类型或附加信息(如错误码、时间戳、重试建议等)时,应定义自己的错误类型。
type MyError struct { Code int Message string Time time.Time } func (e *MyError) Error() string { return fmt.Sprintf("[%d] %s at %v", e.Code, e.Message, e.Time) }使用示例:
func riskyOperation() error { return &MyError{ Code: 4001, Message: "database connection timeout", Time: time.Now(), } }调用方可以判断错误类型并做针对性处理:
if err := riskyOperation(); err != nil { if myErr, ok := err.(*MyError); ok { log.Printf("Custom error occurred: %v, code: %d", myErr.Message, myErr.Code) // 根据 Code 决定是否重试 } else { log.Printf("Unknown error: %v", err) } }封装错误(Error Wrapping)与链式判断
从 Go 1.13 开始,支持通过 %w 动词包装错误,保留原始错误信息:
if err := readFile(); err != nil { return fmt.Errorf("failed to process config: %w", err) }之后可以使用 errors.Is 和 errors.As 进行判断:
if errors.Is(err, os.ErrNotExist) { log.Println("File does not exist") } var myErr *MyError if errors.As(err, &myErr) { log.Printf("Custom error with code: %d", myErr.Code) }这种方式让错误既保持语义清晰,又能逐层传递上下文,同时支持精确匹配。
最佳实践建议
- 简单错误优先使用 errors.New 或 fmt.Errorf
- 需要分类处理或携带元数据时,定义结构体实现 error 接口
- 跨层级调用时合理使用 %w 包装错误,避免丢失原始信息
- 避免暴露过多内部细节给外部调用者,必要时做错误映射
- 自定义错误的 Error() 方法应返回清晰、一致的描述
基本上就这些。Go 的错误机制虽无异常抛出,但通过接口设计和工具函数组合,依然能实现清晰、可控的错误流管理。关键在于根据场景选择合适的方式,平衡简洁性与表达力。










