模板执行时 panic: template: xxx: xxx is not a field of struct
这是最常遇到的字段访问错误，本质是 Go 的反射机制在 html/template 中找不到对应字段——不是拼写错了，就是字段没导出。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查结构体字段是否以大写字母开头（必须导出，小写字段会被模板忽略）
- 确认传入
Execute的是结构体指针或值本身，而不是嵌套过深的 map 或 interface{} 导致字段链断裂 - 用
fmt.Printf("%+v", v)打印传入数据，验证字段名和层级是否符合预期 - 如果字段名含下划线（如
User_name），Go 模板不会自动转成user_name；它只认原始字段名，且不支持 snake_case 自动映射
template.Execute 返回 nil error，但页面显示空或乱码
这通常不是模板语法错，而是数据为 nil、类型不匹配，或模板里用了未定义的变量导致静默失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远检查
Execute的返回值：err != nil—— 它真会返回错误，别只看 panic - 在模板开头加
{{if .}}OK{{else}}EMPTY{{end}}快速判断数据是否为空 - 避免直接用
{{.Field.String}}这类链式调用：任一环节为 nil 就整个表达式求值为 ""，不报错也不提示 - 启用模板调试：用
template.Must(template.New("t").Parse(...))让 parse 阶段就暴露语法问题，而不是等到执行时才挂
html/template 自动转义导致 script/style 不生效
html/template 默认把所有 {{.X}} 输出都做 HTML 转义，这是安全设计，但也会把合法的 JS 或 CSS 当成纯文本渲染。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 仅当明确控制内容来源时，用
{{.X | safeHTML}}或{{.X | safeJS}}—— 别无脑加template.HTML类型断言 - 不要在模板里拼接 HTML 字符串再传进去，比如
data := "<b>hello</b>"+template.HTML(data)；应尽量把结构化数据传入，由模板生成标签 - 注意
safeHTML不会校验内容是否真合法 HTML，XSS 风险仍在；服务端仍需对用户输入做白名单过滤
嵌套模板中 define / template 调用失败或重复定义
常见于多个 template.ParseFiles 加载同一组文件，或多次调用 funcMap 注册冲突函数，导致 template: xxx: duplicate definition。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 每个
*template.Template实例是独立作用域；跨文件复用模板需用template.New("base").ParseFiles("base.html", "page.html")一次性加载 - 用
{{template "name" .}}时，确保被调用的name已通过{{define "name"}}声明，且不在{{range}}等 block 内部定义（否则作用域受限） - 避免在 HTTP handler 里反复调用
template.ParseFiles—— 解析开销大，且并发时可能触发竞态；应在 init 或 startup 阶段完成解析并复用实例
真正麻烦的不是语法报错，而是模板里某个 {{with .User}}{{.Name}}{{end}} 因 .User 是 nil 却不报错，结果页面静默丢失整块内容。这种“没声音的错”得靠日志埋点或单元测试覆盖边界数据才能揪出来。
