在go语言中处理错误时，使用fmt.errorf搭配%w动词可保留原始错误信息并添加上下文。1. 使用%w能保持错误链可追溯，便于通过errors.is或errors.as判断错误类型；2. 使用%v仅生成字符串错误，破坏错误链；3. 嵌套错误时每层用%w包装可形成错误链，可通过errors.unwrap提取原始错误；4. 实际使用建议仅在传递错误时用%w，避免重复包装，合理利用errors.is和errors.as进行错误断言。
在Go语言中，处理错误时经常需要保留原始错误信息，同时添加额外的上下文来帮助排查问题。使用
fmt.Errorf搭配
%w动词是一种常见且推荐的方式，它不仅能包装错误，还能保持原始错误链可追溯。
错误包装的基本用法
当你想为一个错误添加上下文时，可以用
fmt.Errorf并配合
%w格式化动词。例如：
err := doSomething()
if err != nil {
return fmt.Errorf("failed to do something: %w", err)
}这样返回的错误会包含你添加的信息，同时保留原始错误。这对于后期通过
errors.Is或
errors.As进行错误判断非常有用。
立即学习“go语言免费学习笔记（深入）”；
需要注意的是，只有 %w
可以用于错误包装，其他格式化动词（如
%v）只会生成字符串，不会保留原始错误对象。
为什么应该使用 %w
而不是 %v
如果你写成这样：
return fmt.Errorf("failed to do something: %v", err)那这个新错误就只是一个普通的字符串错误，无法再用 errors.Is
或 errors.As
来匹配原始错误。这会破坏错误链，导致上层代码难以判断具体错误类型。
所以，当你希望保留原始错误的类型和内容时，必须使用
%w。
如何正确地嵌套多个错误上下文
有时候你可能在多个层级都添加了上下文。比如：
func top() error {
err := middle()
if err != nil {
return fmt.Errorf("top failed: %w", err)
}
return nil
}
func middle() error {
err := bottom()
if err != nil {
return fmt.Errorf("middle failed: %w", err)
}
return nil
}
func bottom() error {
return fmt.Errorf("bottom error")
}最终返回的错误链是这样的：
top failed: middle failed: bottom error
你可以通过
errors.Unwrap层层提取，或者用
errors.Is直接判断是否包含某个底层错误。
但要注意：
- 每次用
%w
包装都会创建一个新的错误对象 - 不要过度包装，否则错误链会变得冗长难读
- 如果只是记录日志，不需要用
%w
，直接输出即可
实际使用中的几个建议
-
只在需要传递错误给调用方时才使用
%w
，如果是当前函数内部处理错误并记录日志，直接用%v
或打印即可。 - 避免重复包装同一个错误，容易造成错误链混乱。
-
使用
errors.Cause
（第三方库）或errors.Unwrap
（标准库）提取原始错误。 - 如果你使用 Go 1.13+，可以利用
errors.Is
和errors.As
来做错误断言。
基本上就是这些。合理使用
fmt.Errorf和
%w，可以在不牺牲错误语义的前提下，让错误信息更清晰、更容易调试。
