异常教程

Go fmt.Printf 格式化字符串（手把手讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

从基础开始：fmt.Printf 的核心功能

在 Go 语言中，fmt.Printf 是一个功能强大的工具，用于将数据以指定格式输出到控制台。它结合了格式化字符串（Format String）和可变参数列表，能够灵活地将不同类型的数据组合成可读性强的输出结果。对于编程初学者来说，掌握 fmt.Printf 的用法，不仅能提升代码的可读性，还能为后续学习 Go 的高级特性打下基础。

格式化字符串的简单示例

格式化字符串的核心在于占位符（Placeholder），即 % 符号后接的字符。例如：

package main  

import "fmt"  

func main() {  
    name := "Alice"  
    age := 25  
    fmt.Printf("姓名：%s，年龄：%d\n", name, age)  
}

输出结果：

姓名：Alice，年龄：25

在这个例子中：

  • %s 用于表示字符串类型参数；
  • %d 用于表示整数类型参数；
  • \n 是转义字符，用于换行。

参数与占位符的对应规则

fmt.Printf 的参数列表中，第一个参数是格式化字符串，后续参数按顺序填充到占位符的位置。例如：

fmt.Printf("%v 的类型是 %T\n", 42, 42)

输出结果：

42 的类型是 int

这里 %v 是通用占位符，会直接输出参数的值；%T 会输出参数的类型。

初级陷阱：参数类型与占位符不匹配

如果参数类型与占位符不匹配，程序会报错。例如：

// 错误示例：试图用 %d 输出字符串  
fmt.Printf("%d", "Hello") // 编译时错误

此时 Go 编译器会直接报错，提示类型不匹配。因此，在使用 fmt.Printf 时，需确保参数类型与占位符的类型要求一致。

进阶技巧：掌握更多占位符与格式化选项

常用占位符类型

下表列出了 fmt.Printf 中常用的占位符及其作用：

占位符作用
%v通用占位符，直接输出参数的值。对于结构体等复杂类型，会自动展开字段。
%T输出参数的类型名称。
%d整数（十进制）。
%b整数（二进制）。
%o整数（八进制）。
%x整数（十六进制，小写字母）。
%X整数（十六进制，大写字母）。
%s字符串。
%cUnicode 码点对应的字符。
%f浮点数，格式为 xxx.xx。
%e浮点数的指数形式（如 1.23e+04）。

宽度与精度控制

占位符可以附加宽度（Width）和精度（Precision）修饰符，以更精细地控制输出格式。

宽度控制

宽度修饰符定义了输出的最小字符数，若内容不足则补空格，超过则截断。例如：

fmt.Printf("|%-5d|", 12)   // 左对齐，宽度为5  
fmt.Printf("|%5d|", 12345) // 右对齐，宽度为5，超出则显示全部

输出结果：

|12   |  
|12345|

精度控制

精度修饰符（. 后接数字）用于限制浮点数的小数位数或字符串的最大长度：

// 保留两位小数  
fmt.Printf("%.2f", 3.1415926) // 输出：3.14  

// 截断字符串至前5个字符  
fmt.Printf("%.5s", "HelloWorld") // 输出：Hello

进阶用例：复杂数据的格式化

结构体的格式化

对于结构体，%v 会自动展开字段，但可以结合 %+v 显示字段名称：

type Person struct {  
    Name string  
    Age  int  
}  

p := Person{Name: "Bob", Age: 30}  
fmt.Printf("%+v\n", p)

输出结果：

{Name:Bob Age:30}

切片与映射的格式化

使用 %#v 可以输出 Go 代码形式的值，便于调试：

slice := []int{1, 2, 3}  
mapExample := map[string]int{"a": 1, "b": 2}  
fmt.Printf("%#v\n", slice)     // 输出：[]int{1, 2, 3}  
fmt.Printf("%#v\n", mapExample) // 输出：map[string]int{"a":1, "b":2}

常见问题与解决方案

问题1：参数数量与占位符不匹配

如果提供的参数数量与占位符数量不一致，Go 会抛出运行时错误。例如：

fmt.Printf("参数数量不对：%d %d\n", 1) // 输出错误：too few arguments

解决方案：检查参数数量，确保与占位符一一对应。

问题2：转义字符的特殊处理

若需在字符串中直接输出 % 符号，需使用 %% 进行转义：

fmt.Printf("百分比：%%d 表示整数\n") // 输出：百分比：%d 表示整数

问题3：浮点数精度丢失

由于浮点数的二进制表示问题，直接输出可能产生精度误差。例如：

fmt.Printf("%f", 0.1 + 0.2) // 可能输出 0.30000000000000004

解决方案：使用 %f 的精度修饰符或 math.Round 函数处理。

实战案例：格式化日志与表格

案例1：日志输出

结合时间、错误信息和变量值，可以快速生成结构化的日志：

package main  

import (  
    "fmt"  
    "time"  
)  

func main() {  
    err := "数据库连接失败"  
    fmt.Printf("[%s] 错误：%s，重试次数：%d\n", time.Now().Format("15:04:05"), err, 3)  
}

输出示例：

[14:23:05] 错误：数据库连接失败，重试次数：3

案例2：输出表格

通过宽度控制，可以生成对齐的表格：

fmt.Printf("|%-10s|%-15s|%-5d|\n", "ID", "Name", "Age")  
fmt.Printf("|%-10s|%-15s|%-5d|\n", "001", "Alice", 25)  
fmt.Printf("|%-10s|%-15s|%-5d|\n", "002", "Bob", 30)

输出结果：

|ID        |Name           |Age  |  
|001       |Alice          |25   |  
|002       |Bob            |30   |

结论：fmt.Printf 的学习价值

fmt.Printf 是 Go 开发中不可或缺的工具，其格式化字符串机制不仅简化了输出逻辑，还通过丰富的占位符和修饰符支持，满足了从基础到复杂场景的需求。对于编程初学者，建议从简单用例开始，逐步尝试宽度、精度等高级功能；中级开发者则可通过结合结构体、切片等复杂数据类型，探索更灵活的输出方式。

掌握 Go fmt.Printf 格式化字符串 的核心在于理解占位符的规则与参数的对应关系，并通过实际项目中的日志、调试信息输出等场景，不断巩固技能。记住，实践是提升的关键——尝试将代码示例改写为自己的项目需求，你会更快地成长为一名熟练的 Go 开发者。

最新发布

查看更多文章