Go 错误处理应使用 fmt.Errorf(推荐 %w 包装保留错误链)、%v 打印错误、%q 安全插值字符串,并统一用 log 包而非 fmt 输出错误,确保可调试、类型安全且符合 Go 习惯。

Go 的 fmt 包本身不提供“错误格式化输出”的专用函数,但 Go 语言约定使用 error 接口和 fmt.Errorf、fmt.Sprint/Printf 等组合来清晰、一致地输出错误信息。关键不是“错误格式化”,而是“如何按 Go 习惯正确构造和展示错误”。
用 fmt.Errorf 构建带上下文的错误
推荐用 fmt.Errorf(尤其是带 %w 动词)包装底层错误,保留原始错误链,便于调试和判断类型:
-
✅ 推荐(保留错误链):
return fmt.Errorf("failed to open config file: %w", os.Open("config.json")) -
❌ 避免(丢失原始错误):
return errors.New("failed to open config file")或fmt.Sprintf("failed to open config file: %v", err)
打印错误时优先用 %v 和 %+v
在日志或调试输出中显示错误,应根据需求选择格式动词:
-
%v:显示错误的默认文本(最常用,简洁) -
%+v:显示完整错误栈(需错误实现了fmt.Formatter,如github.com/pkg/errors或 Go 1.13+ 的 wrapped error) -
%s:仅调用err.Error(),不推荐用于调试,因丢失结构信息
示例:log.Printf("error occurred: %v", err) —— 清晰、标准、兼容所有 error 类型
Python v2.4版chm格式的中文手册,内容丰富全面,不但是一本手册,你完全可以把她作为一本Python的入门教程,教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。
避免在错误消息里拼接裸字符串
不要手动用 + 或 fmt.Sprintf 拼接路径、变量等敏感内容,易出错且不安全:
-
❌ 不安全(可能含空格、特殊字符):
fmt.Sprintf("failed to read %s: %s", filename, err.Error()) -
✅ 更健壮(自动转义、类型安全):
fmt.Errorf("failed to read %q: %w", filename, err)(%q安全引号包裹字符串)
日志中区分错误与普通输出
生产环境别混用 fmt.Println 和 log.Printf 输出错误。统一用结构化日志库(如 log/slog)或至少用 log 包:
log.Printf("warning: %v", warnErr)-
log.Printf("error: %v", err)(可配合log.SetPrefix("ERR:")) - 避免:
fmt.Printf("ERROR: %v\n", err)—— 不带时间戳、无级别标识、不易过滤
基本上就这些。核心是:用 fmt.Errorf 包装、用 %v 打印、用 %q 安全插值、用 log 而非 fmt 做终端输出。不复杂但容易忽略。









