贝利信息

如何使用Golang格式化输出文本_Golang fmt Printf与Sprintf使用技巧

日期:2025-12-17 00:00 / 作者:P粉602998670
fmt包是Go文本格式化核心工具,Printf输出到标准输出,Sprintf返回字符串,二者共享动词与修饰符;需按类型选%d、%s、%v等动词,用宽度精度控制对齐与截断,注意参数匹配防panic。

Go 的 fmt 包是处理文本格式化最常用、最可靠的工具,其中 fmt.Printf 直接输出到标准输出,fmt.Sprintf 则返回格式化后的字符串——两者共享同一套动词(verbs)和修饰符,掌握它们能让你的输出更清晰、调试更高效、日志更规范。

基础动词:按类型选对“%”符号

Go 不自动推断类型,必须显式指定格式动词,常见且实用的有:

宽度、精度与对齐:控制输出“长相”

在动词前加修饰符,能精细控制格式,比如:

  • %5s:字符串至少占 5 字符宽,右对齐(不足补空格)
  • %-5s:左对齐
  • %05d:数字不足 5 位时,左边补 0(42 → 00042
  • %.2f:浮点数保留 2 位小数(3.14159 → 3.14
  • %8.2f:总宽 8,含小数点和两位小数,右对齐

注意:精度对字符串表示最大长度(%.3s 截取前 3 字符),对数字才表示小数位数。

Printf vs Sprintf:别混用输出目标

两者参数完全一致,区别只在“去哪”:

  • fmt.Printf("name: %s, age: %d", "Tom", 28) → 直接打印到终端
  • s := fmt.Sprintf("name: %s, age: %d", "Tom", 28) → 得到字符串 "name: Tom, age: 28",可用于拼接、日志记录、HTTP 响应等

常见误用:想构造字符串却用了 Printf 导致内容直接刷屏;或者该立刻输出调试信息时,却用 Sprintf 再手动 fmt.Println ——多此一举。

安全提示:避免运行时 panic

格式动词数量必须匹配参数个数,否则会 panic:

  • ✅ 正确:fmt.Printf("id=%d, name=%s", 123, "Lee")
  • ❌ 错误:fmt.Printf("id=%d, name=%s", 123) → panic: missing argument for verb s
  • ❌ 错误:fmt.Printf("id=%d", 123, "Lee") → 多余参数被忽略(但会触发 vet 警告)

建议开启 go vet 检查(现代 IDE 通常默认集成),它能提前发现这类格式错误。

基本上就这些。fmt 的能力不复杂但容易忽略细节,熟练后写日志、生成配置、做 CLI 提示都更得心应手。