template.ParseFiles读取失败主因是路径相对于可执行文件而非源码；字段需导出并加tag才能在模板中访问；Execute执行根模板，ExecuteTemplate按名执行子模板；HTML内容需转为template.HTML并用safeHTML避免转义。
template.ParseFiles 读取失败的常见原因
直接调用 template.ParseFiles 却返回 nil 模板或 panic，大概率是路径问题。Go 的模板文件路径是相对于 os.Executable() 所在目录（即二进制运行起点），不是相对于源码位置，也不是相对于 go run 命令所在目录（go run 下更易出错）。
- 调试时先用
os.Getwd()打印当前工作目录，确认文件是否真在预期路径下 - 推荐统一用
embed.FS+template.ParseFS（Go 1.16+），避免部署时路径漂移：import _ "embed" //go:embed templates/*.html var tmplFS embed.FS t := template.Must(template.New("").ParseFS(tmplFS, "templates/*.html")) - 若仍用
ParseFiles，建议显式拼接绝对路径：filepath.Join(filepath.Dir(os.Args[0]), "templates", "index.html")
传入 struct 时字段必须导出且带 tag
模板里写 {{.Name}} 却渲染为空？Go 模板只能访问导出字段（首字母大写），且字段若含特殊字符或需映射别名，必须加 json 或自定义 tag，并在 template 中用对应 key。
- 结构体字段未导出 → 模板看不到：
name string❌，应为Name string✅ - 想让
UserName字段在模板中叫user_name，需加 tag：UserName string `json:"user_name"`，然后模板中用{{.user_name}}（注意：默认不识别jsontag，需手动设置FuncMap或改用map[string]interface{}） - 更稳妥的做法是传
map[string]interface{}，绕过反射限制，尤其适合动态字段场景
template.Execute 与 ExecuteTemplate 的关键区别
两者都用于渲染，但触发逻辑不同：前者直接执行根模板，后者按名称查找并执行子模板（{{define "xxx"}}...{{end}} 定义的块）。
-
t.Execute(w, data)：只执行模板树的顶层模板（通常是ParseFiles读入的第一个文件），忽略所有define块，除非该顶层模板内显式{{template "xxx"}} -
t.ExecuteTemplate(w, "layout.html", data)：指定执行名为"layout.html"的模板（文件名或define名），适合多模板复用布局 - 常见错误：定义了
{{define "main"}}...却调用Execute，结果啥也不输出——因为根模板没内容，只是个空壳
HTML 自动转义导致样式丢失怎么办
模板默认对 {{.Content}} 中的 、>、" 等做 HTML 转义，防止 XSS，但也会让传入的 HTML 片段变成纯文本。
立即学习“go语言免费学习笔记（深入）”；
- 确认内容可信且需原样渲染时，用
{{.Content | safeHTML}}，前提是Content类型是template.HTML（不是string） - 赋值时强制转换：
data.Content = template.HTML(rawHTMLString) - 切勿在未校验输入的情况下滥用
safeHTML，否则引入 XSS 风险 - 如果只是想禁用某处转义，又不想改类型，可用
{{printf "%s" .Content | safeHTML}}，但语义不如直接用template.HTML清晰
真正麻烦的是嵌套模板间的数据作用域和 with/range 引起的上下文切换——它不会报错，但字段突然找不到，得逐层检查 . 指向是否符合预期。
