Golangfmt包使用与格式化技巧

一分耕耘，一分收获！既然都打开这篇《Golang fmt包用法与格式化输出》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新Golang相关的内容，希望对大家都有所帮助！

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，默认以换行符为分隔，但行为差异明显：

• fmt.Scan 会跳过所有前导空白（包括换行、空格、tab），直到遇到第一个非空白字符；读到空白即停止，**不消费结尾换行符** → 下次调用可能立刻返回空值
• fmt.Scanln 要求输入必须以换行结束，且**不接受行内空格分隔的多个值**（比如输入 "a b\n"，它只读到 "a" 就停）
• 更稳方案：用 bufio.NewReader(os.Stdin) + ReadString('\n') 显式控制换行符处理，再用 strings.TrimSpace 清理

结构体输出时，%#v 和 %+v 的实际用途区别

两者都用于调试结构体，但目标场景不同：

• %+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，就会让非法输入静默通过。

以上就是《Golangfmt包使用与格式化技巧》的详细内容，更多关于的资料请关注golang学习网公众号！