%w 是 Go 1.13 引入的错误包装动词，用于嵌入原始 error 并保留 Unwrap() 方法，使 errors.Is() 和 errors.As() 可正常工作；用 %s 会丢失类型信息导致判断失效。
fmt.Errorf 带 %w 是什么，为什么不能直接用 %s
用 fmt.Errorf("failed to open file: %s", err) 会丢失原始错误的类型和方法（比如 os.IsNotExist() 判断就失效），而 %w 是 Go 1.13 引入的动词，专用于**包装错误（error wrapping）**：它把原错误作为字段嵌入新错误，同时保留 Unwrap() 方法，让调用方能逐层解包、检查底层原因。
常见错误现象：errors.Is(err, os.ErrNotExist) 返回 false，即使底层确实是文件不存在——因为用了 %s 或字符串拼接，原始错误被转成纯文本，类型信息彻底丢失。
-
%w只接受实现了error接口的值，传nil会导致 panic（注意不是返回nil错误） - 一个
fmt.Errorf中最多只能有一个%w，多写会报编译错误：cannot use %w more than once - 如果想包装多个错误，得用第三方库（如
github.com/pkg/errors）或自定义结构体，标准库不支持
怎么正确用 fmt.Errorf("%w") 包装并保留原始行为
核心是：用 %w 替换掉原来写死的错误描述位置，并确保传入的是原始 error 值（不是 err.Error()）。
err := os.Open("missing.txt")
if err != nil {
// ✅ 正确：用 %w 包装，保留可判断性
return fmt.Errorf("open config file failed: %w", err)
// ❌ 错误：转成字符串，丢失类型
// return fmt.Errorf("open config file failed: %s", err.Error())
}
这样返回的错误，下游可以继续用 errors.Is() 或 errors.As() 检查：
-
errors.Is(myErr, os.ErrNotExist)→true（如果底层是os.ErrNotExist） -
errors.As(myErr, &pathErr)→ 能成功提取*os.PathError -
fmt.Printf("%+v", myErr)会显示完整错误链（含文件名、行号等）
什么时候不该用 %w？常见误用场景
%w 不是万能胶水，乱用反而破坏错误语义或引入空指针风险。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 原始错误是
nil时别硬套：fmt.Errorf("something: %w", err)在err == nil时 panic —— 应先判空，或改用%v/%s - 不想暴露底层细节时（比如数据库连接错误内部信息敏感），就不该包装，直接返回新错误：
return errors.New("service unavailable") - 日志中只读取错误消息（
err.Error()）时，%w没意义；只有需要程序逻辑判断或调试追踪时才需要它 - HTTP handler 中返回给前端的错误响应，通常不该带
%w包装后的堆栈，避免泄露服务端实现
包装后如何调试和打印完整错误链
标准 fmt.Println(err) 只显示最外层消息，看不出包装关系；要用 %+v 才能看到所有层级的错误和位置。
err := fmt.Errorf("read header: %w", fmt.Errorf("decode json: %w", io.EOF))
fmt.Println(err) // → read header: decode json: unexpected EOF
fmt.Printf("%+v\n", err) // → read header: decode json: unexpected EOF
// Unwrap() -> decode json: unexpected EOF
// Unwrap() -> unexpected EOF
注意：%+v 的输出格式依赖运行时是否启用了 -gcflags="-l"（禁用内联），实际项目中建议配合 errors.Unwrap() 循环手动展开，或用 errors.Is() 直接做语义判断，而不是依赖字符串匹配。
真正难的不是怎么写 %w，而是想清楚哪一层该包装、哪一层该截断——这取决于你的错误处理契约：调用方是否需要知道底层细节，还是只需要知道“操作失败”就够了。
