使用%w包装错误并结合errors.Is和errors.As提取，可实现链式错误传递与精准匹配，保留上下文且便于定位问题。
在Go语言中，错误处理是程序健壮性的关键部分。随着Go 1.13引入对错误包装（wrapping）的支持，以及Go 1.20进一步增强errors包的能力，开发者可以更清晰地进行错误的链式传递与信息封装。合理使用这些特性，有助于定位问题源头并保留上下文信息。
使用%w格式动词包装错误
Go通过fmt.Errorf中的%w动词实现错误包装，被包装的错误可通过errors.Unwrap提取，形成错误链。
示例如下：
package main
import (
"errors"
"fmt"
)
func readFile(name string) error {
if name == "" {
return fmt.Errorf("invalid filename: %w", errors.New("filename is empty"))
}
// 模拟其他错误
return fmt.Errorf("read failed: %w", errors.New("IO error"))
}
func processFile() error {
return readFile("")
}
func main() {
err := processFile()
fmt.Println("Error:", err)
// 输出：Error: read failed: invalid filename: filename is empty
}
提取错误链中的原始错误
使用errors.Is和errors.As可安全比对或提取特定类型的错误，避免直接比较。
立即学习“go语言免费学习笔记（深入）”；
示例：判断是否包含某个底层错误
if errors.Is(err, os.ErrNotExist) {
fmt.Println("File does not exist")
}
或提取自定义错误类型：
var pathErr *os.PathError
if errors.As(err, &pathErr) {
fmt.Printf("Path error: %v\n", pathErr.Path)
}
添加上下文而不丢失原错误
在中间层函数中，应保留原始错误以便上层处理，同时附加当前上下文。
正确做法：
func download(url string) error {
resp, err := http.Get(url)
if err != nil {
return fmt.Errorf("failed to fetch %s: %w", url, err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return fmt.Errorf("bad status: %s: %w", resp.Status, ErrDownloadFailed)
}
return nil
}
这样调用方既能通过errors.Is检测ErrDownloadFailed，也能看到完整调用路径。
自定义错误类型结合包装
对于复杂场景，可定义携带额外信息的错误类型，并实现Unwrap方法参与错误链。
type AppError struct {
Msg string
Code int
Err error
}
func (e *AppError) Error() string {
return fmt.Sprintf("[%d] %s: %v", e.Code, e.Msg, e.Err)
}
func (e *AppError) Unwrap() error {
return e.Err
}
// 使用
err := &AppError{Msg: "db query failed", Code: 500, Err: sql.ErrNoRows}
wrapped := fmt.Errorf("service layer error: %w", err)
之后仍可用errors.Is(wrapped, sql.ErrNoRows)准确匹配。
基本上就这些。关键是用好%w、Is和As，在传递错误时既保留细节又提供上下文，让排查更高效。
