Go模板中FuncMap注册函数需显式添加，不支持直接调用未注册函数或结构体方法；嵌套模板同名define会静默覆盖；Execute不可传nil；New模板不继承FuncMap，须手动Funcs()。
template.FuncMap 里注册的函数不能直接调用方法
Go 的 text/template 不支持在模板中调用结构体方法（哪怕是指针接收者），只认 FuncMap 里显式注册的函数。你写 {{.User.Name}} 没问题，但 {{title .User.Name}} 要求 title 是提前注册进 FuncMap 的函数，不是随便 import 进来的包函数。
常见错误现象：function "title" not defined 或 can't call method on nil（实际是没注册导致 fallback 到字段访问）。
实操建议：
- 所有要模板内用的函数，必须手动塞进
FuncMap，比如map[string]interface{}{"title": strings.Title} - 避免注册带副作用的函数（如
log.Println），模板执行可能多次、并发，副作用难控 - 如果函数需要访问上下文（如 HTTP request），别硬塞进去——改用预处理数据，把结果传进
Execute
嵌套 template 时 name 冲突会静默覆盖
template 动作引用的是已定义的子模板名，而 define 是全局作用域。多个文件 ParseFiles 时，同名 define 会后覆盖前，不报错也不警告。
立即学习“go语言免费学习笔记（深入）”；
使用场景：生成多文件代码（如 proto 生成器、CRD 模板），常把通用逻辑拆成 _helpers.tpl 和具体资源模板分开维护。
实操建议：
- 给每个模板加命名空间前缀，比如
go:struct:fields而非简单叫fields - 用
template.Must包裹Parse，它会在 parse 阶段就 panic 掉语法错误，但对 name 冲突无能为力——得靠命名规范兜底 - 不要依赖
range循环里动态拼接 template 名，{{template (printf "field-%s" $.Type)}}在编译期无法校验，运行时报template "field-int" not defined
template.Execute 传入 nil 会 panic，但空 struct 不会
Execute 第二个参数为 nil 时，模板里任何 .Field 访问都会触发 panic: reflect: Call of nil func value 类似错误；但传入一个零值 struct（如 struct{}{}）则安全，只是字段全为空。
性能影响：nil 检查成本极低，但 panic 后恢复代价高，不适合做控制流（比如“没数据就跳过”）。
实操建议：
- 永远不要传
nil给Execute，哪怕你确定模板里只用if .Data判断——因为.Data本身访问就会 panic - 统一用指针接收数据，并在模板开头加
{{if not .}} {{error "data required"}} {{end}}，但注意error是自定义函数，需注册且返回 error - 更稳妥的做法：封装一层
SafeExecute(t *template.Template, w io.Writer, data interface{}) error，内部先判空再调Execute
template.New 创建的模板不自动继承 FuncMap
调用 template.New("xxx") 返回的新模板实例，默认 FuncMap 是空的，即使你刚从另一个模板 Clone() 过来，FuncMap 也不会自动复制——除非显式调 Funcs()。
容易踩的坑：写了个通用模板工厂函数，每次 New 后忘了 Funcs(myFuncs)，结果所有自定义函数都失效，还查半天是不是路径/命名错了。
实操建议：
- 把模板创建和初始化打包成函数，比如
newCodeTemplate(name string) *template.Template，内部固定调Funcs和Option - 避免混用
template.Parse和template.New(...).Parse：前者复用默认模板，后者是全新实例，FuncMap 状态不一致 - 调试时打印
t.Funcs()结果（需转 map 遍历），确认关键函数是否在列
最麻烦的其实是嵌套模板 + 自定义函数 + 数据结构指针接收者这三者叠加时的 nil 判定逻辑——模板里 {{if .User}} {{template "user-block" .User}} {{end}} 看似安全，但如果 .User 是 *User 且为 nil，template 动作仍会 panic，得在外层用 {{with .User}} 包一层。
