最常见崩溃是模板访问未导出字段导致 panic，因 Go 模板仅支持导出字段（首字母大写）；须检查结构体字段、嵌套字段及 map 键名大小写；务必处理 Execute 错误，解析应在启动时完成并用 template.Must 暴露错误；HTML 转义不可绕过，避免 XSS。
模板执行时 panic: reflect.Value.Interface: cannot return value obtained from unexported field
这是最常遇到的崩溃，根本原因是传入 template.Execute 的结构体字段没导出（首字母小写），而模板里又试图访问它。Go 模板只能读取导出字段，反射层面直接拒绝访问未导出成员。
- 检查传入数据的结构体定义，所有要被模板读取的字段必须大写开头，比如
type User struct { Name string }而不是name string - 如果用 map 传值，键名必须是字符串，且大小写敏感 ——
map[string]interface{}{"Name": "Alice"}才能被{{.Name}}访问 - 嵌套结构体也要逐层检查导出性，比如
User.Profile.Age要求Profile和Age都导出
Execute 返回 error 但没打印或处理，导致页面空白或 500
template.Execute 和 ExecuteTemplate 几乎总返回非 nil 错误（语法错、字段不存在、类型不匹配等），但很多人只写 t.Execute(w, data) 忽略返回值，HTTP 响应就卡在半路。
- 务必检查错误：
if err := t.Execute(w, data); err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) } - 开发期建议加日志：
log.Printf("template exec error: %v", err)，避免错误被吞掉 - 注意
w是http.ResponseWriter，一旦写入 header 就不能再调用http.Error，所以错误处理必须在写响应前完成
模板解析阶段就失败，template.ParseFiles 或 Parse 返回 error
这类错误发生在渲染前，比如模板语法错误、嵌套 {{end}} 缺失、函数未定义等。如果没检查，后续 Execute 会 panic 或静默失败。
- 不要在 handler 里反复调用
ParseFiles—— 解析开销大，且并发下可能竞争；应该在程序启动时一次性解析并复用*template.Template - 用
template.Must快速暴露解析错误：t := template.Must(template.ParseFiles("index.html"))，出错直接 panic，适合初始化阶段 - 自定义函数注册必须在
Parse前完成，否则模板里调用{{myfunc .}}会报function "myfunc" not defined
HTML 特殊字符没转义，导致 XSS 或页面错乱
Go 模板默认对 {{.Field}} 做 HTML 转义，但如果你用了 {{.Field | safeHTML}} 或 {{.Field | js}} 等，又没确保内容可信，风险立刻出现。
立即学习“go语言免费学习笔记（深入）”；
- 除非明确需要渲染 HTML，否则永远不要用
safeHTML；用户输入一律走默认转义 - 动态生成 JS 内容时，用
{{.Data | js}}而不是拼接字符串，避免引号/反斜杠破坏语法 - 注意
template.HTML类型绕过转义，但它是“信任标记”，不是安全转换 —— 把用户输入强制转成template.HTML等于主动开后门
真正难的不是写对模板语法，而是把错误流从解析、执行到 HTTP 响应全链路串起来，尤其别让 Execute 的 error 消失在 if 条件里。线上环境还容易忽略模板文件路径变化或热加载逻辑，导致旧二进制还在读不存在的文件。
