Go 字符串格式化

在日常开发中,我们经常需要把姓名、年龄、价格等不同类型的变量组装成一段完整的文本。前面学习字符串拼接时我们知道,加号(+)要求两边必须都是字符串,直接把字符串和数字相加会引发编译报错。

遇到这种场景,我们可以使用标准库 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() 函数的执行效率会更高。

上一篇:

下一篇:

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号