Golang fmt包常用输出函数对比

fmt.Println自动换行且参数间加空格，fmt.Print无换行无空格；%v通用安全，%d整数，%s字符串，%q原始字节，%t布尔；Sprint/Sprintf/Sprintln返回字符串；Fprint系列写入任意io.Writer。

fmt.Println 和 fmt.Print 有什么区别

主要区别在换行行为和参数处理方式。fmt.Println 自动在末尾加换行，且会在相邻参数间插入空格；fmt.Print 完全不加换行，也不加空格，输出完全由你控制。

常见错误是误以为 fmt.Print 会自动换行，结果多行输出挤在同一行。比如：

fmt.Print("hello")
fmt.Print("world")

输出是 helloworld，而用 fmt.Println 就是：

fmt.Println("hello")
fmt.Println("world")

输出是两行：hello 和 world。

• 需要快速拼接字符串或写日志前缀时，用 fmt.Print
• 调试打印单行信息、希望格式干净时，优先用 fmt.Println
• fmt.Print 对 nil 指针或未初始化结构体不会 panic，但可能输出意外内容（如 ），要注意上下文是否可接受

fmt.Printf 的格式动词怎么选

动词决定值的解释方式，选错会导致输出不符合预期，比如把 int 用 %s 输出会 panic，把指针用 %d 会输出地址数值而非内容。

最常用且安全的组合：

• 通用输出：用 %v —— 自动适配类型，结构体、切片、map 都能展开
• 调试看内存地址：用 %p（注意传的是指针，不是值）
• 整数输出：优先用 %d；十六进制用 %x（小写）或 %X（大写）
• 字符串/字节切片：用 %s；要显示原始字节（含不可见字符）用 %q
• 布尔值：用 %t，比 %v 更明确

示例：

name := "Alice"
age := 25
fmt.Printf("Name: %s, Age: %d\n", name, age) // Name: Alice, Age: 25
fmt.Printf("Raw: %q\n", []byte("hi\n"))        // Raw: "hi\\n"

fmt.Sprint / fmt.Sprintf / fmt.Sprintln 的适用场景

这三个函数不直接输出到终端，而是返回 string，适合构造日志内容、HTTP 响应体、SQL 查询等需要拼接后复用的场景。

• fmt.Sprint：参数间无空格，无换行 —— 类似 fmt.Print 的返回版
• fmt.Sprintln：参数间加空格，末尾加换行 —— 类似 fmt.Println 的返回版
• fmt.Sprintf：支持格式化动词，最灵活 —— 是字符串模板拼接的主力

性能注意点：频繁调用 fmt.Sprintf 会产生较多临时字符串，高并发日志中建议用 strings.Builder + fmt.Fprint 组合替代。

常见误用：

// ❌ 错误：想拼接却用了 Println，结果带了多余换行
logMsg := fmt.Sprintln("user login:", userID)

// ✅ 正确：用 Sprintf 控制格式
logMsg := fmt.Sprintf("user login: %d", userID)

fmt.Fprint 系列函数为什么常被忽略

它们把输出写入任意 io.Writer，比如文件、网络连接、bytes.Buffer，是构建可测试、可重定向输出的关键。

例如单元测试中捕获日志：

var buf bytes.Buffer
fmt.Fprintln(&buf, "debug info")
output := buf.String() // 得到 "debug info\n"

又比如写入文件：

f, _ := os.Create("log.txt")
fmt.Fprintln(f, "start processing")
f.Close()

容易踩的坑：

• 忘记检查 fmt.Fprint 等函数的返回 error，尤其写入网络或磁盘时
• 对 nil io.Writer 调用会 panic，生产代码中务必判空
• fmt.Fprint 不自动 flush，写入 bufio.Writer 后记得调 Flush()

真正复杂的 I/O 场景里，fmt.Fprint 系列不是“备选”，而是默认选择 —— 因为标准输出只是 os.Stdout 这个 io.Writer 的一个实例而已。