fmt包是高频高风险I/O工具,误用动词或参数易致乱码、panic;Sprintf静默拼接未用参数;Scan/Scanln换行处理有陷阱;%+v显字段名调试友好,%#v输出Go字面量含类型。

Go 语言的 fmt 包不是“学完就忘”的语法糖集合,而是日常开发中高频、高风险的 I/O 工具——用错 fmt.Printf 的动词或漏掉参数,轻则输出乱码,重则 panic 或掩盖真实错误。
为什么 fmt.Sprintf 比 fmt.Print 更常被误用
fmt.Sprintf 返回字符串,不直接输出,看似安全,但常见陷阱是:传入参数数量与格式动词不匹配时,它不会 panic,而是把未使用的参数原样拼在末尾(Go 1.22+ 开始部分情况会报编译警告,但运行时仍可能静默出错)。
- 错误写法:
fmt.Sprintf("name: %s, age: %d", "Alice")→ 输出"name: Alice, age: %d"(%d 被当作文本保留) - 正确做法:始终确保参数个数 ≥ 格式动词个数;调试时可临时改用
fmt.Printf,它会在参数不足时 panic,更快暴露问题 - 注意
%v和%+v差异:后者对 struct 会显式打印字段名,调试时更友好
fmt.Scan 和 fmt.Scanln 读取用户输入时的换行符陷阱
这两函数底层依赖 bufio.Scanner,默认以换行符为分隔,但行为差异明显:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
fmt.Scan会跳过所有前导空白(包括换行、空格、tab),直到遇到第一个非空白字符;读到空白即停止,**不消费结尾换行符** → 下次调用可能立刻返回空值 -
fmt.Scanln要求输入必须以换行结束,且**不接受行内空格分隔的多个值**(比如输入"a b\n",它只读到"a"就停) - 更稳方案:用
bufio.NewReader(os.Stdin)+ReadString('\n')显式控制换行符处理,再用strings.TrimSpace清理
结构体输出时,%#v 和 %+v 的实际用途区别
两者都用于调试结构体,但目标场景不同:
立即学习“go语言免费学习笔记(深入)”;
-
%+v:补全字段名,适合快速确认字段值是否符合预期,例如fmt.Printf("%+v", user)→{Name:"Tom" Age:25} -
%#v:输出 Go 语法风格的字面量,包含类型信息,可用于生成可复用的测试数据,例如fmt.Printf("%#v", user)→main.User{Name:"Tom", Age:25} - 注意:若结构体含 unexported 字段(小写开头),
%#v仍会显示其值(反射可读),但json.Marshal类序列化会忽略它们——别依赖%#v判断序列化结果
真正难的不是记住所有动词,而是在日志、调试、用户交互、测试数据生成等不同上下文中,选对那个“刚好够用且不易出错”的函数。比如生产日志里混用 fmt.Printf 和 log.Printf,可能导致时间戳/级别丢失;又比如用 fmt.Sscanf 解析用户输入却没检查返回的 err,就会让非法输入静默通过。

















