模板解析失败时Parse不报错而Execute panic，因Parse仅校验语法结构，不检查变量、函数或嵌套模板定义；应启动时用template.Must(ParseFiles/ParseGlob)提前暴露错误。
模板解析失败时 Parse 不报错，但 Execute panic
这是最常踩的坑：写完 template.Must(template.New("t").Parse(...)) 觉得万事大吉，结果运行时在 Execute 阶段才炸。因为 Parse 只校验语法结构（比如括号匹配、动作起止符），不检查变量是否存在、函数是否注册、嵌套模板是否定义。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 所有模板文件应在启动时一次性
ParseFiles或ParseGlob，并用template.Must包裹——它会在解析失败时直接 panic，避免静默错误 - 若需动态加载模板（如用户上传），必须手动检查
Parse返回的error，不能依赖Must -
template.New("name").Funcs(...).Parse(...)中，Funcs必须在Parse前调用，否则自定义函数在解析期不可见，但错误要到执行时才暴露
undefined variable 错误只在 Execute 时触发
Go 模板不进行静态类型或符号分析。哪怕你传了 nil 或空 struct，只要模板里写了 {{.User.Name}}，而 .User 是 nil，就立刻 panic —— 不是返回空字符串，也不是跳过，而是中断整个响应。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
{{with .User}}{{.Name}}{{end}}替代裸{{.User.Name}}，避免 nil 解引用 - 对可能缺失的字段，统一用
{{if .Field}}{{.Field}}{{else}}default{{end}}，别依赖“没定义就当空”这种错觉 - 测试时务必传入边界数据：空 struct、nil 指针、map 中缺 key 的情况，光测正常流程没用
嵌套模板未定义导致 template: "xxx" is undefined
错误信息里的 "xxx" 是你 {{template "xxx"}} 中写的名称，不是文件名。常见于：模板文件被 ParseFiles 加载，但没显式调用 Template("xxx") 获取子模板；或子模板定义在另一个 template 实例里，彼此隔离。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 所有
{{define "xxx"}}必须在同一个*template.Template实例中定义，跨文件也要用ParseFiles一次性加载，不能分别New再Parse - 用
t.Lookup("xxx") != nil在运行时检查模板是否存在，比等 panic 更可控 - 避免在
define内部再template未定义的名称——这种错误Parse阶段无法发现
HTML 自动转义不是万能的，template.HTML 绕过但有风险
html/template 默认对所有 {{.X}} 输出做 HTML 转义，但如果你传入 template.HTML("<!-- script -->")，它就原样输出。问题在于：这个类型只是个标记，运行时不校验内容是否真合法，也不防 XSS。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 仅对**可信的、服务端生成的 HTML 片段**使用
template.HTML，绝不要用它包裹用户输入 - 需要渲染富文本？先用
bluemonday等库清洗，再转成template.HTML - 注意
text/template和html/template不能混用：前者不转义，后者强制转义，模板函数返回值类型不匹配会导致 panic
真正麻烦的不是错误信息本身，而是模板错误总发生在请求处理中途，且堆栈不指向你写的模板行号。把 Parse 阶段的校验做实，比在 Execute 里捕获 panic 更可靠。
