在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:保留两位小数
举个例子:
立即学习“go语言免费学习笔记(深入)”;
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 的用法不算复杂,但在日常开发中经常被忽略一些细节,稍微注意一下就能写出更清晰、安全的代码。










