1. fmt包概览
Golang fmt包是Go标准库中用于格式化输出与字符串拼接的核心工具，广泛用于日志、调试以及对外输出的文本构造。Its 核心职责在于将数据以可控的格式呈现给终端、文件或网络传输流。通过一系列格式化占位符，开发者可以灵活控制数值、字符串、结构体等类型的展示方式，从而提高可读性和调试效率。
(fmt包)提供了多种函数族来兼顾不同的输出目标：Printf家族输出到标准输出，Sprintf将结果拼接为字符串，Fprintf/Fprint则输出到指定的io.Writer。这种设计使得日志记录、错误信息拼接以及用户界面输出都能以一致的格式完成。
package mainimport "fmt"func main() {name := "张三"age := 30// 1) 直接输出到终端fmt.Printf("用户：%s，年龄：%d\n", name, age)// 2) 结果作为字符串s := fmt.Sprintf("用户：%s，年龄：%d", name, age)_ = s
}
2. Printf与Sprintf的核心区别
Printf与Sprintf的关键差异在于输出目标与返回值：Printf直接将格式化结果输出到标准输出，Sprintf则返回一个已格式化好的字符串供后续使用。这个差异决定了在不同场景下的选型：调试信息直接打印时选Printf，拼接成日志文本再写入日志系统时选Sprintf。
除了基本差异外，fmt包还提供
package mainimport ("fmt""os"
)func main() {name := "李四"// 1) Printf 输出到标准输出fmt.Printf("欢迎，%s！\n", name)// 2) Sprintf 生成字符串msg := fmt.Sprintf("欢迎，%s！", name)_ = msg// 3) Fprintf 输出到自定义写入目标（这里是标准错误输出）fmt.Ffprintf(os.Stderr, "错误信息：用户 %s 发生异常\n", name)
}
3. 常见格式化占位符
3.1 整数与浮点数
整型与浮点型的常用占位符包括：%d（十进制）、%b（二进制）、%o（八进制）、%x/%X（十六进制）、%f（十进制浮点数）、%e/%E（科学计数法）等。结合宽度和精度还可以实现对齐与小数位控制，从而在日志或表格输出中获得整齐的外观。
以下示例展示了不同数值类型的格式化效果，并演示了保留小数位与字段宽度的用法：
package mainimport "fmt"func main() {v := 255f := 3.14159fmt.Printf("十进制: %d, 二进制: %b, 十六进制: %x\n", v, v, v)fmt.Printf("浮点数：%f, 精度 %.2f, 指数表示 %e\n", f, f, f)// 宽度与对齐fmt.Printf("|%-6d|%6.2f|\n", v, f)
}
3.2 字符串与布尔值
字符串与布尔值的占位符包括：%s、%q、%v、%T，以及布尔值的%t。%q会将字符串加上双引号，方便产生可直接输出的可读文本；%T用于显示变量的实际类型，便于调试。
通过这些占位符，可以在一个格式化表达式中同时呈现内容类型与文本可读性：
package mainimport "fmt"func main() {s := "Go语言"ok := truefmt.Printf("字符串: %s, 带引号: %q, 公共占位: %v, 类型: %T\n", s, s, ok, ok)
}
3.3 对象、结构体与组合输出
对象与结构体的输出常用占位符有%v、%+v、%#v和%T，分别展示字段值、字段名、Go语法表示以及类型信息。这在调试时尤为有用，能快速查看数据结构的完整内容。
示例中还可以结合自定义格式，将结构体以特定顺序或自定义文本拼接输出：
package mainimport ("fmt"
)type User struct {Name stringAge int
}func main() {u := User{Name: "王五", Age: 28}fmt.Printf("%v\n", u) // 值表示fmt.Printf("%+v\n", u) // 带字段名称的值fmt.Printf("%#v\n", u) // Go语法表示fmt.Printf("类型: %T\n", u)
}
3.4 宽度、精度与对齐
字段宽度、精度与对齐方式可以显著影响输出的可读性。通过格式化标志位，如-（左对齐）和0（前置填充）等，可以在日志表格中实现对齐效果。
组合示例展示了文本、数字的对齐输出：
package mainimport "fmt"func main() {fmt.Printf("|%-10s|%6d|%6.2f|\n", "name", 42, 3.14159)// 输出结果对齐整齐，便于人工浏览
}
4. 实战案例
4.1 日志行格式化
日志行格式化通常需要时间戳、日志级别和消息文本的稳定排列。利用fmt.Printf或fmt.Sprintf与时间格式化结合，可以高效地构造规范化日志行，便于后续日志聚合与检索。
示例将时间、级别与消息拼接成一行日志，确保可读性与可分析性：
package mainimport ("fmt""time"
)func main() {now := time.Now().Format("2006-01-02 15:04:05")level := "INFO"msg := "服务启动完成"// 直接输出fmt.Printf("[%s] %s: %s\n", now, level, msg)// 也可以拼接成一个字符串再写入日志系统line := fmt.Sprintf("[%s] %s: %s", now, level, msg)_ = line
}
4.2 用户信息字符串拼接
在用户信息展示场景中，将字段按固定格式输出有助于界面美观与一致性。通过Sprintf将多字段整理成单行文本，是常见的UI前置任务。
下面的代码示例演示了如何把姓名、邮箱与ID拼成一条信息：
package mainimport "fmt"func main() {id := 1001name := "赵六"email := "zhao@example.com"line := fmt.Sprintf("ID:%d | Name:%s | Email:%s", id, name, email)fmt.Println(line)
}
4.3 错误包装与信息
错误信息的格式化与包装是Go语言错误处理中的常见需求。结合%w进行错误包装，可以保留原始错误以实现错误链追踪，同时附加自定义上下文信息。
通过fmt.Errorf组合使用，可以实现可维护的错误栈信息：
package mainimport ("errors""fmt"
)func fetch() error {return errors.New("网络请求失败")
}func main() {err := fetch()if err != nil {wrapped := fmt.Errorf("处理请求失败: %w", err) // %w 用于错误包装fmt.Println(wrapped)}
}
