fmt.sprintf 是格式化函数而非拼接函数，仅在需类型转换、进制控制、对齐或结构体展开时使用；纯字符串拼接应避免它，优先用 + 或 strings.builder，且严禁将用户输入作为格式串。

fmt.Sprintf 不是拼接函数，而是格式化函数——它只在需要类型转换、进制控制、对齐或结构体展开时才该用；纯字符串连接请绕开它。

参数顺序错位会导致 %!(EXTRA string=)

常见错误是把格式串和变量混着传：fmt.Sprintf("Name: %s", name, "Age: %d", age)。这会让 fmt.Sprintf 只识别前两个参数（"Name: %s" 和 name），后面两个被当成“未格式化的额外值”，输出变成 Name: Alice%!(EXTRA string=Age: %d, EXTRA int=25)。

• 所有占位符必须提前写死在格式字符串里，比如 "Name: %s, Age: %d"
• 变量必须严格按顺序跟在格式串之后，一个不多、一个不少
• 参数数量不匹配时不会编译报错，但运行时会 panic 或输出奇怪的 %!(EXTRA ...)
• 用 go vet 能捕获大部分这类问题，建议 CI 中强制开启

别用 fmt.Sprintf 做纯字符串拼接

写成 fmt.Sprintf("%s%s%s", a, b, c) 看似省事，实则浪费：它要解析格式串、走反射路径、分配新字符串，比 a + b + c 慢 3–5 倍。

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

• 2～3 个已知 string 类型拼接，直接用 +，编译器会优化成单次分配
• 有非字符串类型（如 int）参与，优先考虑 strconv.Itoa + +，而不是 fmt.Sprintf("%s%d", s, n)
• 循环内拼接（哪怕只有几十次）必须用 strings.Builder，否则 O(N²) 内存拷贝立刻显现
• fmt.Sprint 虽无格式符，但仍走反射，也不如 +

结构体输出用 %+v 而不是 %v

fmt.Sprintf("%v", struct{A, B int}{1, 2}) 返回 {1 2}，字段名丢失、空格不可控；而日志、缓存 key、调试输出往往依赖稳定结构。

• 需要字段名就用 %+v → {A:1 B:2}
• 需要 Go 语法风格（可直接 eval）用 %#v → main.T{A:1, B:2}
• 跨服务传递结构体摘要时，别依赖 %v，应显式实现 String() 方法
• %v 对 map、slice 的输出顺序不保证，不能用于生成一致性 hash

用户输入当 format 参数会 panic

把用户提交的字符串直接塞进 fmt.Sprintf 第一个参数位置，比如 fmt.Sprintf(userInput, x)，一旦含非法格式符（如 "%d %s" 但只传一个参数），就会 runtime panic。

• 永远不要让用户输入控制格式串，这是硬性红线
• 若需动态模板（如邮件模板），先白名单校验格式符，再用 text/template 替代
• HTML 插入前必须 html.EscapeString，否则 fmt.Sprintf 不防 XSS
• fmt.Sprintf 不返回 error，但 panic 是真 panic，无法靠 if 判断规避

真正容易被忽略的是：格式化不是拼接，拼接也不是格式化。选错工具的第一反应不是“结果不对”，而是“怎么越来越慢”。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！