在日常开发中,我们经常需要把姓名、年龄、价格等不同类型的变量组装成一段完整的文本。前面学习字符串拼接时我们知道,加号(+)要求两边必须都是字符串,直接把字符串和数字相加会引发编译报错。
遇到这种场景,我们可以使用标准库 fmt 包中的 fmt.Sprintf() 函数。它的格式符规则与前面学过的 fmt.Printf() 一致,区别在于 fmt.Printf() 会直接打印到屏幕,而 fmt.Sprintf() 是把拼装好的文本作为新字符串返回。
fmt.Sprintf() 语法
在 Go 语言中,fmt.Sprintf() 函数名开头的字母 S 是 “String(字符串)” 的缩写,合起来就是 “按格式生成字符串” 的意思。
语法:
str := fmt.Sprintf("格式化模板", 变量1, 变量2, ...)说明:
第 1 个参数是包含格式符(也叫占位符)的模板字符串,后面的参数则是要依次填入对应位置的变量或值。除了表示百分号本身的 %% 之外,其余格式符都需要与后面的变量按顺序一一对应。常用的格式符如下表所示。
| 格式符 | 适用类型 | 说明 |
|---|---|---|
| %v | 任意类型 | 按默认格式输出 |
| %s | string | 输出字符串 |
| %d | 整型 | 输出十进制整数 |
| %04d | 整型 | 宽度 4 位,不足左侧补 0 |
| %f | 浮点型 | 输出小数,默认保留 6 位 |
| %.2f | 浮点型 | 保留 2 位小数(四舍五入) |
| %c | byte / rune | 输出单个字符 |
| %t | bool | 输出布尔值 |
| %q | string | 输出带双引号的字符串 |
| %% | 无对应变量 | 输出百分号 % 本身 |
注意: 由于 fmt.Sprintf() 只负责生成并返回新字符串,本身不会往屏幕上打印任何内容,小伙伴们调用时记得使用变量接收它的返回值。如果只写一行 fmt.Sprintf("年龄:%d", age) 而不接收返回值,程序运行后屏幕上是看不到任何结果的。
Go 字符串格式化示例
接下来,我们通过几个常见的例子,来看看如何使用 fmt.Sprintf() 组装不同格式的字符串。
示例 1:拼接不同类型的数据
package main
import "fmt"
func main() {
name := "Jack"
age := 20
msg := fmt.Sprintf("姓名:%s,年龄:%d 岁", name, age)
fmt.Println(msg)
}运行结果如下。
姓名:Jack,年龄:20 岁分析:
模板里的 %s 对应字符串变量 name,%d 对应整数变量 age。fmt.Sprintf() 将它们按顺序填入模板后,会生成新字符串 "姓名:Jack,年龄:20 岁" 并保存到变量 msg 中。
我们可以对比一下 fmt.Printf() 和 fmt.Sprintf() 在用法上的差别。
age := 20
fmt.Printf("今年 %d 岁\n", age) // 直接打印到屏幕
s := fmt.Sprintf("今年 %d 岁", age) // 生成字符串并返回可以看到,fmt.Sprintf() 只是把组装好的文本存进变量 s 里供后续使用,因此模板末尾一般不需要像 fmt.Printf() 那样加上 \n 换行符。
当拼接的数据中包含小数,或者我们不想逐个区分每种类型的专属格式符时,可以配合 %.2f 和通用格式符 %v 来使用。下面来看一个例子。
示例 2:控制小数位数与输出百分号
package main
import "fmt"
func main() {
name := "苹果"
price := 12.567
info := fmt.Sprintf("%v售价:%.2f 元(折扣:90%%)", name, price)
fmt.Println(info)
}运行结果如下。
苹果售价:12.57 元(折扣:90%)分析:
这里的商品名 name 使用了通用格式符 %v,不管传入字符串、整数还是布尔值,它都能按默认格式填入。平时如果明确知道变量类型,建议优先写 %s、%d 等专属格式符,方便编译器检查类型。只有在拿不准具体格式符时,我们再使用 %v。
后面的 %.2f 表示将浮点数 price 保留 2 位小数,自动四舍五入为 12.57。此外小伙伴们还要留意模板末尾的 90%%:因为在模板里 % 是格式符的起始标志,如果要在结果中显示普通的百分号 %,必须连续写两个百分号 %% 才行。
在生成订单编号、学号或日期文本时,我们经常需要把数字补齐成固定位数,比如把 7 变成 "0007",或者把月份 8 变成 "08"。此时可以使用 %0Nd 格式符,下面我们再来看一个例子。
示例 3:左侧补 0 对齐位数
package main
import "fmt"
func main() {
id := 7
month := 8
code := fmt.Sprintf("NO-%04d", id) // 不足 4 位时左侧补 0
dateStr := fmt.Sprintf("2026-%02d", month) // 不足 2 位时左侧补 0
fmt.Println(code)
fmt.Println(dateStr)
}运行结果如下。
NO-0007
2026-08分析:
%04d 中的 4 表示总宽度为 4 位,前面的 0 表示位数不足时在左侧补 0,因此整数 7 格式化后的结果为 "0007"。同理,%02d 会把不足 2 位的月份 8 补齐为 "08"。如果数字本身已经达到或超过指定宽度(如月份 12),则会按原样输出。
另外,当一个字符串的首尾藏着看不见的空格或制表符时,普通打印很难一眼察觉。这时可以配合 %q 格式符,让字符串带着双引号显示出来。下面来看一个例子。
示例 4:使用 %q 查看字符串边界
package main
import "fmt"
func main() {
s := " Go "
res1 := fmt.Sprintf("普通输出:%s", s)
res2 := fmt.Sprintf("带引号输出:%q", s)
fmt.Println(res1)
fmt.Println(res2)
}运行结果如下。
普通输出: Go
带引号输出:" Go "分析:
对比两行结果可以看出,使用 %s 时看不清 "Go" 后面有没有空格。而使用 %q 后,外层会自动包上双引号,首尾各两个空格一目了然。而且 %q 还会把隐藏的 \t、\n 按转义形式显示出来,后面调试字符串分割和去空格时会经常用到。
小伙伴们平时如果看到输出里冒出 %!d(string=Go) 这样的奇怪文字,不用慌张。Go 中格式符和变量类型不匹配时不会让程序崩溃,而是直接在结果里印出提示,看到 %! 回头核对变量类型即可。
把文字、数字等多个变量组装成一句话时,使用 fmt.Sprintf() 最清晰直观。如果只是单纯把一个整数转换成字符串(比如把 100 转为 "100"),不需要拼接其他文字,调用 strconv.Itoa() 函数的执行效率会更高。
