fmt是go语言内置的基础格式化工具,提供Print、println、printf三种输出方式,支持%v、%+v、%#v等格式动词调试,需注意类型匹配与nil安全,并可通过Stringer接口和调试开关提升可维护性。

fmt 是 Go 语言最基础、最常用的输出和格式化工具,不需要额外依赖,开箱即用。 它不只用来“打印日志”,更是调试、数据检查、用户交互和简单文本生成的核心手段。掌握它的常见用法和易错细节,能让你写得更快、查得更准、代码更健壮。
基础输出:Print、Println、Printf 的区别
这三个函数常被混用,但行为差异明显:
- fmt.Print:原样输出,不换行,也不加空格。比如
fmt.Print("hello"); fmt.Print("world")输出helloworld - fmt.Println:自动在末尾加换行,且会在相邻参数间插入一个空格。比如
fmt.Println("hello", "world")输出hello worldn - fmt.Printf:支持格式化字符串(类似 C 的 printf),是调试时最灵活的选项。例如
fmt.Printf("name=%s, age=%d", name, age)
常用格式动词与调试技巧
格式动词是 Printf 系列的灵魂。调试时这几个最实用:
- %v:默认格式,适合快速看值。结构体、切片、map 都能友好展开
- %+v:对结构体额外显示字段名,比如
{Name:"Alice" Age:30}→{Name:"Alice" Age:30}变成{Name:"Alice" Age:30}(字段名可见) - %#v:输出 Go 语法风格的字面量,方便复制粘贴或比对原始结构。比如
[]int{1,2,3}会输出[]int{1, 2, 3} - %q:字符串加双引号并转义,适合检查含空格、换行、不可见字符的字符串
- %t:布尔值,输出 true/false,避免误读 0/1
避免 panic:注意类型匹配与 nil 安全
fmt 函数不会编译报错,但运行时容易 panic:
立即学习“go语言免费学习笔记(深入)”;
- 格式动词和参数类型不匹配会 panic,比如
fmt.Printf("%d", "hello") - 对 nil 指针或 nil slice 使用 %v 通常安全,但用 %s 打印 nil []byte 会 panic
- 调试时不确定值是否为 nil,可先判断再打印:
if s != nil { fmt.Printf("s=%s", string(*s)) },或用 %#v 更稳妥
进阶技巧:自定义 Stringer 接口与调试开关
让自定义类型输出更清晰:
- 实现
String() string方法,所有 fmt 输出都会自动调用它。适合隐藏敏感字段或美化展示 - 调试阶段可加个全局变量控制输出:
const debug = true,然后if debug { fmt.Printf("DEBUG: %+vn", x) } - 用
fmt.Sprintf构造字符串而非直接打印,便于组合、测试或按需输出
基本上就这些。fmt 不复杂但容易忽略细节,用熟了,一行 Printf 往往比打断点还快。