Go text/template 中无法直接调用 fmt.Sprintf，需通过 FuncMap 注册自定义 sprintf 函数，参数为 format 字符串和变参，内部调用 fmt.Sprintf；同时推荐使用内置函数处理基础操作，复杂格式化应在 Go 层完成。
Go text/template 中无法直接调用 fmt.Sprintf
模板里不能用 fmt.Sprintf，因为 text/template 的函数集是隔离的，只暴露了预定义的内置函数（如 print、len、index），不包含标准库的格式化能力。硬塞 fmt.Sprintf 会报 function "sprintf" not defined 错误。
常见错误现象：在模板里写 {{ sprintf "%s-%d" .Name .ID }}，运行时 panic 或渲染为空。
- 必须提前在
template.FuncMap中注册自定义函数，才能在模板中使用 - 注册的函数签名必须是
func(...interface{}) string或类似可接受任意参数的形式 - 函数体内部可以安全调用
fmt.Sprintf，但不能直接传入模板上下文未导出的类型（比如未导出字段）
注册自定义 sprintf 函数到 FuncMap
最直接的解法是把 fmt.Sprintf 封装成模板可用函数：
funcMap := template.FuncMap{
"sprintf": func(format string, a ...interface{}) string {
return fmt.Sprintf(format, a...)
},
}
然后在模板中就能用了：
{{ sprintf "user_%s_%d" .Username .ID }}
{{ sprintf "%.2f%%" .Score }}
注意点：
- 参数顺序必须严格匹配：第一个参数是
format string，后面是变参a ...interface{} - 如果传入非字符串类型的
format（比如nil或整数），fmt.Sprintf会 panic，建议加简单校验 - 不要在
sprintf里做耗时操作（如 HTTP 请求），模板渲染是同步阻塞的
处理 map 遍历时的复杂格式（如带分隔符的键值对）
单纯靠 range + sprintf 仍可能漏掉末尾逗号问题。例如：
{{ range $k, $v := .Attrs }}{{ $.Prefix }}.{{$k}}={{$v}},{{ end }}
结果会多一个尾随逗号。正确做法是用 join 配合切片：
- 先在 Go 代码中把 map 转成
[]string切片，每个元素是sprintf("key=%v", v)的结果 - 再用
strings.Join拼接，最后注入模板 - 或注册一个更智能的
kvjoin函数，接收 map 和 format 字符串，内部处理分隔逻辑
示例注册函数：
"kvjoin": func(m map[string]interface{}, format, sep string) string {
var parts []string
for k, v := range m {
parts = append(parts, fmt.Sprintf(format, k, v))
}
return strings.Join(parts, sep)
}
模板中调用：{{ kvjoin .Attrs "%s=%v" ", " }}
字符串截取、大小写转换等基础操作别硬写逻辑
Go 模板内置了 lower、upper、title、substr 等函数，够用就别自己封装。
容易踩的坑：
-
substr "hello" 1 3表示从索引 1 开始取 3 个字节，不是字符 —— 中文会乱码，需先转 rune 切片再操作 -
lower对非 ASCII 字符（如德语 ü）可能不生效，实际依赖strings.ToLower的规则 - 如果需要正则替换，必须注册
regexReplace类函数，模板本身不支持regexp
真正复杂的格式化逻辑（比如按 locale 格式化日期、千分位数字、HTML 转义）应该在 Go 层做完再传入模板，而不是塞进模板里拼凑。
