如何在Golang中实现错误包装与解包

Go 1.13起通过%w包装错误可保留原始信息，使用errors.Is和errors.As能语义化解包判断，自定义错误需实现Unwrap方法以支持解包，提升错误处理精准度。

在Go语言中，错误处理是程序健壮性的重要组成部分。从Go 1.13开始，标准库引入了错误包装（error wrapping）机制，使得开发者可以在保留原始错误信息的同时添加上下文，也支持后续对错误进行解包以检查底层原因。以下是实现错误包装与解包的实用方法。

错误包装：使用 %w 格式动词

通过 fmt.Errorf 配合 %w 动词，可以将一个已有的错误包装进新错误中，同时保留其原始结构，便于后续分析。

示例：

if err != nil {
return fmt.Errorf("failed to read config: %w", err)
}

这样生成的错误可以通过 errors.Unwrap 提取原始错误。注意，只有使用 %w 才会触发包装行为，%v 或 %s 不具备此功能。

立即进入“豆包AI人工智官网入口”；

立即学习“豆包AI人工智能在线问答入口”；

错误解包：使用 errors.Is 和 errors.As

直接调用 errors.Unwrap(err) 可以获取被包装的下一层错误，但更推荐使用 errors.Is 和 errors.As 进行语义化判断。

豆包爱学

豆包旗下AI学习应用

26

查看详情

• errors.Is(err, target)：判断错误链中是否存在某个特定错误（如 os.ErrNotExist）
• errors.As(err, &target)：判断错误链中是否包含指定类型的错误，并赋值给目标变量

示例：

if errors.Is(err, os.ErrNotExist) {
log.Println("config file not found")
}
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Printf("filesystem error on path: %s", pathErr.Path)
}

自定义错误类型支持包装

如果需要定义自己的错误类型并支持包装，只需在结构体中嵌入一个 error 字段，并实现 Error() 方法。

示例：

type MyError struct {
Msg string
Err error // 嵌入原始错误
}
func (e *MyError) Error() string {
return e.Msg + ": " + e.Err.Error()
}
func (e *MyError) Unwrap() error {
return e.Err
}

这样构造的错误可以被 errors.Is 和 errors.As 正常处理，Unwrap 方法是解包的关键。

基本上就这些。合理使用包装能让错误携带更多上下文，而正确解包有助于精准处理异常情况。关键是理解 %w 的作用以及优先使用 Is/As 而非直接比较错误字符串。