使用error wrapping可保留原始错误上下文并添加信息，从Go 1.13起通过fmt.Errorf配合%w实现包装，每个调用仅支持一个%w且只能包装error接口值；errors.Is用于判断错误链中是否包含目标错误，errors.As则检查是否存在特定类型错误并赋值；可通过errors.Unwrap循环遍历错误链逐层输出信息，有助于调试但应避免过度包装导致冗余。
在Golang中使用error wrapping可以保留原始错误的上下文，同时添加额外的信息，帮助调试和排查问题。从Go 1.13开始，标准库引入了对error wrapping的支持，主要通过fmt.Errorf配合%w动词来实现。
使用 fmt.Errorf 和 %w 进行 error wrapping
当你需要在原有错误基础上添加上下文时，可以使用fmt.Errorf并配合%w：
-
%w只能包装实现了error接口的值，否则会panic - 每个
fmt.Errorf调用只能使用一个%w
<span style="color:blue;">package</span> main
<span style="color:blue;">import</span> (
<span style="color:darkred;">"fmt"</span>
<span style="color:darkred;">"os"</span>
)
<span style="color:blue;">func</span> readFile(filename <span style="color:blue;">string</span>) <span style="color:blue;">error</span> {
_, err := os.Open(filename)
<span style="color:blue;">if</span> err != <span style="color:blue;">nil</span> {
<span style="color:blue;">return</span> fmt.Errorf(<span style="color:darkred;">"failed to open file %s: %w"</span>, filename, err)
}
<span style="color:blue;">return</span> <span style="color:blue;">nil</span>
}
<span style="color:blue;">func</span> processFile() <span style="color:blue;">error</span> {
err := readFile(<span style="color:darkred;">"nonexistent.txt"</span>)
<span style="color:blue;">if</span> err != <span style="color:blue;">nil</span> {
<span style="color:blue;">return</span> fmt.Errorf(<span style="color:darkred;">"processing failed: %w"</span>, err)
}
<span style="color:blue;">return</span> <span style="color:blue;">nil</span>
}
使用 errors.Is 和 errors.As 判断 wrapped error
标准库提供了errors.Is和errors.As来处理包装后的错误：
- errors.Is(a, b)：判断错误链中是否存在与目标相等的错误
- errors.As(err, &target)：判断错误链中是否有指定类型的错误，并赋值给target
<span style="color:blue;">package</span> main
<span style="color:blue;">import</span> (
<span style="color:darkred;">"errors"</span>
<span style="color:darkred;">"fmt"</span>
<span style="color:darkred;">"os"</span>
)
<span style="color:blue;">func</span> main() {
err := processFile()
<span style="color:blue;">if</span> err != <span style="color:blue;">nil</span> {
<span style="color:blue;">if</span> errors.Is(err, os.ErrNotExist) {
fmt.Println(<span style="color:darkred;">"file does not exist"</span>)
}
<span style="color:blue;">var</span> pathError *os.PathError
<span style="color:blue;">if</span> errors.As(err, &pathError) {
fmt.Printf(<span style="color:darkred;">"path error occurred on path: %s\n"</span>, pathError.Path)
}
}
}
查看完整的错误链
你可以手动遍历错误链，打印每一层的错误信息：
立即学习“go语言免费学习笔记（深入）”；
<span style="color:blue;">func</span> printErrorChain(err <span style="color:blue;">error</span>) {
<span style="color:blue;">for</span> i := 0; err != <span style="color:blue;">nil</span>; i++ {
fmt.Printf(<span style="color:darkred;">"level %d: %v\n"</span>, i, err)
err = errors.Unwrap(err)
}
}
这会逐层输出被包装的错误，有助于调试复杂调用栈中的问题。
基本上就这些。正确使用error wrapping能让你的程序错误处理更清晰，既保留细节又便于定位根源。注意不要过度包装，避免冗余信息干扰判断。
