Go通过error接口实现错误处理,常见类型包括:1. 内置error接口,用errors.New或fmt.Errorf创建;2. 第三方库如pkg/errors提供带堆栈的Wrap、WithStack;3. 自定义结构体实现Error方法以携带错误码等信息;4. 系统错误如*os.PathError可通过类型断言识别;5. 预定义错误值如io.EOF应使用errors.Is比较;6. Go 1.13+支持%w包装错误,并用errors.Unwrap、Is、As操作错误链。

在Go语言中,错误处理是通过内置的 error 接口实现的。虽然Go没有像其他语言那样的异常机制,但它提供了灵活且清晰的方式来表示和处理错误。以下是常见的错误类型及其使用场景。
1. 内置 error 类型
Go 的 error 是一个接口类型,定义如下:
type error interface {
Error() string
}
任何实现了 Error() 方法的类型都可以作为错误使用。最简单的创建错误方式是使用标准库中的 errors.New 或 fmt.Errorf:
- errors.New("自定义错误信息"):创建一个基础错误。
- fmt.Errorf("格式化错误: %v", value):支持格式化输出,并可嵌套原有错误(从 Go 1.13 起支持 %w)。
2. 带堆栈信息的错误(第三方库)
原生 error 不包含调用堆栈。为了调试方便,常用第三方库如 github.com/pkg/errors 提供带堆栈的错误:
立即学习“go语言免费学习笔记(深入)”;
- errors.Wrap(err, "上下文信息"):包装已有错误并添加堆栈。
- errors.WithStack(err):为错误附加当前堆栈。
- errors.Cause(err):递归获取原始错误。
注意:从 Go 1.13 开始,官方 errors 包增强了对错误包装的支持,部分功能可替代该库。
3. 自定义错误类型
你可以定义结构体来携带更多错误信息,比如错误码、状态、时间等:
type MyError struct {
Code int
Message string
Time time.Time
}
func (e *MyError) Error() string {
return fmt.Sprintf("[%v] 错误 %d: %s", e.Time, e.Code, e.Message)
}
这样可以在处理错误时进行类型断言,获取详细信息。
4. 系统错误(os.Error 等)
某些包会返回特定类型的错误,例如文件操作中的 *os.PathError、网络错误 *net.OpError 等。这些是系统调用失败的具体封装,通常包含操作名、路径、底层错误等字段。
可以通过类型断言判断具体错误类型:
if e, ok := err.(*os.PathError); ok {
log.Println("路径错误:", e.Path)
}
5. 错误值(预定义错误变量)
标准库中常使用预定义的错误变量,如:
- io.EOF:表示读取结束,不是真正“异常”。
- sql.ErrNoRows:SQL 查询无结果。
使用 errors.Is(err, target) 可以安全比较是否为某个预定义错误。
6. 包装错误(Go 1.13+)
Go 1.13 引入了错误包装机制,支持用 %w 格式符包装错误:
err := fmt.Errorf("处理失败: %w", innerErr)
之后可用 errors.Unwrap()、errors.Is() 和 errors.As() 进行解包或类型匹配:
- errors.Is(err, target):判断错误链中是否包含目标错误。
- errors.As(err, &target):将错误链中某个错误赋值给指定类型变量。










