Golang fmt库格式化输出详解

在Golang中，fmt库的格式化输出功能通过动词、宽度、精度等控制输出样式。1. 常用动词包括%v、%+v、%#v、%T、%d、%x、%s、%q、%f等，分别用于不同数据类型的格式化输出；2. 可设置宽度和精度以控制输出对齐与截断，如%10s、%.5s、%8.2f；3. %+v和%#v适用于结构体输出，显示字段名或Go语法格式；4. 使用时需注意参数顺序匹配、避免字符串拼接、考虑性能优化，推荐优先使用fmt.Printf替代拼接方式。

在Golang中，fmt库是标准库中最常用的包之一，用来做格式化输入输出。虽然看起来简单，但想用得灵活、用得准确，还是得理解一些细节。这篇文章就来说说怎么用好fmt里的格式化输出功能。

基本的格式动词（verbs）

fmt库支持多种格式动词来控制输出内容的展示方式，这些动词以百分号 % 开头。常见的比如：

• %v：默认格式输出任意值
• %+v：结构体时会显示字段名
• %#v：Go语法格式表示值
• %T：输出值的类型
• %d：十进制整数
• %x：十六进制整数（小写）
• %s：字符串
• %q：带引号的字符串或转义字符
• %f：浮点数
• %.2f：保留两位小数

举个例子：

name := "Tom"
age := 25
fmt.Printf("名字：%s，年龄：%d\n", name, age)

这样输出就是：

名字：Tom，年龄：25

使用动词的时候要注意顺序和参数匹配，否则容易出错。

格式化选项中的宽度与精度

除了基本动词，你还可以设置宽度和精度，让输出更整齐美观。

• 宽度（width）：指定该值至少占用多少字符宽度，不足则补空格。
• 精度（precision）：对浮点数而言是小数位数，对字符串则是最大长度。

例如：

fmt.Printf("%10s\n", "hello")   // 右对齐，总共占10位
fmt.Printf("%.5s\n", "hello world") // 只取前5个字符，输出hello
fmt.Printf("%8.2f\n", 123.456)  // 输出  123.46（总宽8位，两位小数）

这种技巧在打印表格或者日志对齐时特别有用。

使用结构体标签配合 %+v 和 %#v

当你打印一个结构体变量时，如果加上 +v 或 #v，输出的内容会有明显区别：

type User struct {
    Name string
    Age  int
}

u := User{"Alice", 30}
fmt.Printf("%v\n", u)   // {Alice 30}
fmt.Printf("%+v\n", u)  // {Name:Alice Age:30}
fmt.Printf("%#v\n", u)  // main.User{Name:"Alice", Age:30}

特别是调试阶段，%+v可以让你一眼看出字段名和对应的值，非常实用。

避免常见坑点

• 参数顺序不匹配：动词的顺序必须和参数一一对应，否则可能输出错误甚至 panic。
• 字符串拼接 vs 格式化：不要把变量拼接到字符串里再传给 fmt.Println，而是优先使用 fmt.Printf 或 fmt.Sprintf。
• 性能考虑：频繁调用 fmt.Sprintf 可能影响性能，需要大量字符串拼接时建议用 strings.Builder。

比如下面这个做法就不推荐：

log.Println("User: " + user.Name + ", Age: " + strconv.Itoa(user.Age))

应改为：

log.Printf("User: %s, Age: %d", user.Name, user.Age)

基本上就这些。fmt 的用法不算复杂，但在日常开发中经常被忽略一些细节，稍微注意一下就能写出更清晰、安全的代码。