17370845950

该用 fmt.Printf 还是 fmt.Sprintf 取决于是否需要立即输出：需直接打印到终端、日志或 io.Writer 时选 fmt.Printf；需构造字符串用于拼接、传参或嵌入模板时选 fmt.Sprintf。

fmt.Printf 直接输出到标准输出，fmt.Sprintf 返回格式化后的字符串——选哪个取决于你是否需要“打印”还是“构造字符串”。

什么时候该用 fmt.Printf 而不是 fmt.Sprintf

当你想立刻把内容输出到终端、日志或 io.Writer（比如文件、网络连接）时，用 fmt.Printf 更直接高效。

• 避免额外分配字符串内存：如果只是打印调试信息，fmt.Sprintf 会先生成字符串再输出，多一次拷贝
• 支持写入任意 io.Writer：比如 fmt.Fprintf(os.Stderr, "error: %v", err)
• 错误提示场景常见：比如 fmt.Printf("user %s not found\n", name) 比先 Sprintf 再 Println 更简洁

fmt.Sprintf 的典型使用场景

fmt.Sprintf 不输出，只返回 string，适合拼接、组装、传参、嵌入模板等不能/不该立即输出的场合。

• 构建 SQL 查询（注意防注入，此处仅作格式示意）：query := fmt.Sprintf("SELECT * FROM users WHERE id = %d", userID)
• 生成 HTTP 响应体：body := fmt.Sprintf(`{"status":"ok","data":%s}`, jsonData)
• 作为函数参数传递：log.Print(fmt.Sprintf("retry #%d for %s", attempt, url))
• 与 strings.ReplaceAll 或正则配合前预处理：key := fmt.Sprintf("cache:%s:%d", category, version)

常见格式动词和易错点

Golang 的格式动词比 C 更严格，类型不匹配不会自动转换，容易 panic 或输出意外结果。

• %v 是最安全的通用打印，但结构体默认不带字段名；加 +%v 可显示字段名（如 {Name:"Alice" Age:30}）
• %d 只接受整数类型：fmt.Sprintf("%d", int64(42)) 合法，但 fmt.Sprintf("%d", float64(42)) 编译报错
• %s 只接受 string 或 []byte（后者会转成字符串），传 int 会输出对应 Unicode 字符（比如 %s 打印 65 得到 "A"）
• 浮点数精度控制：%.2f 表示保留两位小数，%e 用科学计数法，%g 自动选更紧凑的形式

name := "Bob"
age := 28
s1 := fmt.Sprintf("Hello %s, you are %d years old.", name, age) // 正确
s2 := fmt.Sprintf("Age: %s", age)                              // 错！%s 不能接 int，编译失败
s3 := fmt.Sprintf("Code: %c", 65)                              // 输出 "Code: A"

性能与逃逸：Sprintf 在循环里要小心

每次调用 fmt.Sprintf 都会分配新字符串，频繁调用（尤其在 hot path 或大循环中）可能引发 GC 压力和内存逃逸。

• 替代方案：用 strings.Builder 手动拼接（适合已知大致长度的场景）
• 或者预分配缓冲区：var b strings.Builder; b.Grow(128); b.WriteString(...)
• 简单日志场景可考虑 log.Printf，它内部做了优化，比 fmt.Sprintf + log.Print 略快
• 用 go tool compile -gcflags="-m" yourfile.go 可检查是否发生堆逃逸

真正难的不是记住 %d 和 %v 的区别，而是意识到：当格式化结果要反复构造、又不立刻输出时，Sprintf 的隐式分配成本很容易被忽略。