必须用Funcs方法向template.Template的FuncMap添加可导出函数并配合template.Must校验；函数需首字母大写、签名严格匹配，禁止panic，应防御性处理nil和错误输入。
怎么给 template.Template 添加自定义函数
直接往 FuncMap 里塞函数，再用 Funcs 方法挂载——这是唯一可靠路径。别试图在 Parse 后补函数，那没用；也别想靠闭包“动态注入”，template 包不认这个。
常见错误是把函数签名写错：必须是可导出（首字母大写）、参数和返回值类型固定。比如 func(string) string 可以，func(interface{}) string 在调用时容易 panic，因为模板传参是反射解包的，类型不匹配就炸。
-
FuncMap是map[string]interface{}，key 是模板里用的名字，value 是函数本身 - 函数必须是可导出的（Go 的 visibility 规则），否则
template运行时会静默忽略 - 多个模板共用同一
FuncMap时，注意函数里别依赖闭包捕获的局部变量，容易引发并发读写问题
FuncMap 里函数怎么处理错误和 nil
模板函数不能返回 error 类型（除非你手动在模板里用 if 判断并输出空字符串）。更实际的做法是：函数内部做防御性检查，遇到非法输入直接返回空或默认值，避免 panic。
比如写一个 truncate 函数，输入 nil 的 string 或负数长度，就原样返回空串，而不是让模板崩溃。用户不会看到 panic 堆栈，只会看到渲染结果异常——这比报错更难排查。
立即学习“go语言免费学习笔记（深入）”；
- 不要在自定义函数里 panic，
template会吞掉 panic 并转成空字符串，调试时毫无线索 - 如果真要报错，得靠提前校验 + 返回空值，再配合日志或监控埋点（比如用
log.Printf打点） - 接收指针或 interface{} 参数时，务必先用
reflect.ValueOf(x).Kind() == reflect.Invalid检查是否为 nil
为什么 template.Must 和 Funcs 要连用
因为 Funcs 返回的是同一个 *Template 实例，但它不校验函数是否合法——只有到 Parse 或 Execute 阶段才真正校验。而 template.Must 是帮你提前捕获 Parse 失败的 panic，避免运行时才发现函数名冲突或语法错误。
典型坑是：两个不同模板用了相同函数名但不同实现，又没用 Must 包裹，结果上线后某个模板突然空白，日志里还找不到原因。
-
template.New("name").Funcs(fm).Parse(tpl)不保证安全；应该写成template.Must(template.New("name").Funcs(fm).Parse(tpl)) - 如果模板字符串来自配置或数据库，
Must就更关键——它能把语法错误挡在启动阶段 - 注意
Funcs是链式调用，但不是线程安全的；别在 goroutine 里边执行Funcs边Execute
跨 package 使用自定义函数要注意什么
函数必须定义在可导出包里，且调用方能 import 到——这点看似简单，但容易被忽略。比如你在 internal/util 里写了 FormatTime，主模板代码却在 cmd/ 下，没加 import 就直接塞进 FuncMap，编译过不去。
另一个隐形问题是 init 顺序：如果函数依赖某个全局变量（比如配置项），而那个变量在 init() 里初始化，但模板构建发生在更早时机，就会拿到零值。这种情况不会报错，但输出永远不对。
- 所有自定义函数建议集中放在一个
funcs.go文件里，并统一用小写前缀（如strTruncate）避免命名冲突 - 避免函数依赖未初始化的全局状态；真需要配置，用函数参数传入，而不是从包级变量读
- 如果函数逻辑复杂，考虑封装成结构体方法，再通过
FuncMap注入绑定后的实例方法
Must 包裹和函数导出性检查，这两个点一错，问题就藏得深。 
