template渲染失败主因是路径、字段可见性或包选错：html/template与text/template不可混用，小写字段模板不可见，parsefiles以os.getwd()为基准查文件，execute时需确保字段首字母大写，html内容需safehtml显式标记，嵌套模板名严格区分大小写。
template 渲染失败，八成不是语法写错，而是路径、字段可见性或包选错了——html/template 和 text/template 不能混用，结构体小写字段在模板里直接不可见，ParseFiles 找不到文件几乎全是工作目录惹的祸。
ParseFiles 总报 open xxx: no such file or directory
Go 的 template.ParseFiles 默认以 os.Getwd()（当前工作目录）为基准查文件，不是代码所在目录，也不是 go run 执行目录。CI、Docker 或 IDE 启动时 pwd 很可能和你本地开发时不一致。
- 调试时先加两行：
fmt.Println("wd:", os.Getwd())和abs, _ := filepath.Abs("templates/base.html"); fmt.Println("abs:", abs)，确认路径是否存在 - 推荐方案：用
filepath.Join(filepath.Dir(runtime.Caller(0)), "templates", "base.html")拼出相对于源码文件的绝对路径 - 更稳方案（Go 1.16+）：把模板放进
embed.FS，再用template.ParseFS(fs, "templates/*.html")—— 路径确定、打包进二进制、无运行时依赖
Execute 时 panic: reflect.Value.Interface: cannot return value...
这是新手最高频的 panic。Go 模板只能访问结构体中首字母大写的导出字段。哪怕 JSON tag 写了 json:"user_name"，只要字段名是 userName 或 user_name，模板里 {{.userName}} 就会 panic。
- 检查所有传入模板的数据结构，确保要渲染的字段名首字母大写（如
Name、Email） - 别依赖反序列化工具自动生成的小写字段；用
map[string]interface{}临时绕过，但 lose 类型安全 - 若必须封装私有字段，提供公开方法（如
func (u User) FullName() string { return u.firstName + " " + u.lastName }），模板里调{{.FullName}}
HTML 标签被当成纯文本显示，比如 Hello
这不是 bug，是 html/template 的默认保护行为：所有 {{.Content}} 插值都会自动 HTML 转义。如果你传的是已构造好的 HTML 字符串（如富文本编辑器输出），它会被当作文本渲染。
- 可信内容需显式标记：
{{.Content | safeHTML}}—— 注意是小写safeHTML，不是SafeHTML - 别用
strings.ReplaceAll拼接 HTML 后塞进模板，这等于绕过转义，XSS 风险拉满 - 如果整个模板都不想转义（比如生成 Markdown 或 SQL），换用
text/template包；但渲染用户输入的 HTML 时，绝不能用text/template
嵌套模板 {{define}} 写了却没生效
{{define}} 定义的模板名是严格字符串匹配，大小写、空格、斜杠全算数。定义了 {{define "header"}}，却在 ExecuteTemplate 里传 "Header" 或 "layout/header"，结果就是静默输出空内容，不报错也不提示。
- 执行前用
tmpl.Templates()拿到所有已加载模板，遍历打印t.Name()确认名称完全一致 - 避免在
{{define}}名里用路径分隔符（如layouts/header），容易因系统路径规则导致不一致；统一用短名（header、footer）更可靠 -
{{template "header" .}}中的点.是传给子模板的数据，不是当前作用域；若子模板需要不同数据，得显式传参，比如{{template "header" .PageData}}
os.Getwd()、字段必须导出、safeHTML 必须显式调用、模板名大小写敏感。这些点漏一个，调试半小时起步。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
