Go 自带的 go vet 工具可在编译前静态检查 fmt.Printf 等函数的格式化字符串与实际传入参数的数量、类型是否匹配，有效捕获常见日志和输出错误。
go 自带的 `go vet` 工具可在编译前静态检查 `fmt.printf` 等函数的格式化字符串与实际传入参数的数量、类型是否匹配，有效捕获常见日志和输出错误。
在 Go 开发中，因 fmt.Printf、log.Printf、fmt.Sprintf 等函数的格式化字符串（如 %s、%d、%v）与后续参数不一致而导致的运行时 panic 或静默错误十分常见——例如少传参数、类型不匹配（用 %d 格式化字符串）、或冗余参数。这类问题不会被 Go 编译器捕获（Go 是静态类型语言，但 fmt 函数族使用 ...interface{}，类型信息在编译期被擦除），因此必须依赖静态分析工具提前发现。
幸运的是，自 Go 1.0 起内置的 go vet 已完整支持对 fmt 家族函数（包括 fmt.Print*、log.Print*、fmt.Errorf、fmt.Sprint* 等）的格式化校验。该检查在 Go 1.6 及更高版本中默认启用部分规则，而格式字符串验证（printf checker）是其核心子检查项之一。
✅ 使用方式：
在项目根目录执行以下任一命令即可触发检测：
go vet ./... # 或针对特定文件 go vet main.go utils/log.go # 或启用全部检查（含实验性规则） go vet -all ./...
? 典型报错示例：
以下代码会被 go vet 明确指出问题：
package main
import "fmt"
func main() {
name := "Alice"
age := 30
fmt.Printf("Hello %s, you are %d years old.\n", name) // ❌ 缺少 age 参数
fmt.Printf("Score: %d\n", "95") // ❌ 类型不匹配：%d 期望 int，传入 string
fmt.Printf("ID: %s, Name: %s\n", 123) // ❌ 参数不足，仅传 1 个，需 2 个 %s
}
运行 go vet . 后将输出类似提示：
main.go:8:2: Printf format %d has arg "95" of wrong type string main.go:7:2: Printf call has 1 arg but printf verb %d requires 2 args main.go:9:2: Printf call has 1 arg but printf verb %s requires 2 args
⚠️ 注意事项：
- go vet 是静态分析工具，非编译器组成部分，因此需主动调用（可集成进 CI 流程或 pre-commit 钩子）；
- 它不检查运行时拼接的格式字符串（如 fmt.Printf(fmtStr, args...) 中 fmtStr 为变量），仅分析字面量格式串；
- 若使用自定义日志封装（如 MyLog.Printf(...)），需通过 //go:veter 注释或 vet 的 -printfuncs 标志显式注册函数签名，否则无法识别；
- 推荐在 CI 中加入 go vet ./... 并设置为失败门禁，避免带格式错误的代码合入主干。
? 总结：无需额外安装工具，go vet 即是 Go 官方推荐、开箱即用的解决方案。它精准、轻量、可靠，是保障日志与格式化输出健壮性的第一道防线。务必将其纳入日常开发与自动化流程。
