使用fmt优化Go错误输出：1. 用fmt.Errorf("%w")包装错误并添加上下文；2. 通过%v/%+v控制错误详情， %+v可显示堆栈（需第三方库）；3. 自定义error类型实现fmt.Formatter接口以支持格式化；4. 结合log与fmt输出结构化日志，提升可读性与调试效率。
在Go语言中，error 是一种内置类型，用于表示函数执行过程中的错误状态。而 fmt 包提供了丰富的格式化输出能力。将二者结合使用，不仅能清晰地传递错误信息，还能提升程序的可维护性和调试效率。以下是一些实用的技巧，帮助你优化错误输出格式。
1. 使用 fmt.Errorf 添加上下文信息
原始 error 通常缺乏上下文，直接返回可能难以定位问题。通过 fmt.Errorf 可以在原有 error 基础上附加调用路径、参数值等信息。
例如：
if err := readFile(name); err != nil {
return fmt.Errorf("failed to read file %s: %w", name, err)
}
这里使用了 %w 动词包装原始错误，既保留了底层错误，又增加了上下文，便于追踪。
立即学习“go语言免费学习笔记（深入）”；
2. 利用 %v、%+v 输出 error 详细信息
某些第三方库（如 github.com/pkg/errors）支持堆栈追踪。结合 fmt 的格式动词可以控制输出细节：
- %v：输出错误消息
- %+v：输出错误消息及完整堆栈信息
示例：
fmt.Printf("Error: %v\n", err) // 简要信息
fmt.Printf("Detail: %+v\n", err) // 包含堆栈
注意：原生 error 不支持 %+v 显示堆栈，需借助 errors 包实现。
3. 自定义 error 类型并实现 fmt.Formatter 接口
若想完全控制错误的格式化输出，可以让自定义 error 类型实现 fmt.Formatter 接口。
例如：
type MyError struct {
Msg string
Line int
}
func (e *MyError) Error() string {
return fmt.Sprintf("error at line %d: %s", e.Line, e.Msg)
}
func (e *MyError) Format(f fmt.State, verb rune) {
switch verb {
case 'v':
if f.Flag('+') {
io.WriteString(f, "Detailed error info:\n")
io.WriteString(f, e.Msg)
fmt.Fprintf(f, "\nLine: %d", e.Line)
return
}
fallthrough
case 's':
io.WriteString(f, e.Error())
}
}
这样在使用 fmt.Printf("%+v", err) 时就能输出扩展信息。
4. 结合 log 与 fmt 输出结构化错误日志
虽然 fmt 不是日志库，但在开发阶段常配合 log 使用。可通过 fmt 格式化 error 后写入日志。
建议做法：
log.Printf("[ERROR] Operation=LoadConfig, File=%s, Err=%v", filename, err)
或将错误转为 map 后 JSON 输出，便于日志系统解析。
基本上就这些。合理使用 fmt 的格式化功能，能显著提升 Go 程序中错误信息的可读性与实用性。关键是不要丢失原始错误，同时提供足够的上下文。不复杂但容易忽略。
