模板文件路径找不到，ParseFiles 报 open template.html: no such file or directory
Go 的 html/template 默认从当前工作目录（不是二进制所在目录）读取模板文件，启动服务时 pwd 切换或 systemd 服务没设 WorkingDirectory 都会导致路径失效。
推荐统一用 embed 嵌入模板（Go 1.16+），避免运行时路径依赖：
import _ "embed"
//go:embed templates/*.html
var templateFS embed.FS
t := template.Must(template.New("").ParseFS(templateFS, "templates/*.html"))
如果必须用文件系统，用 filepath.Join(os.Getenv("GOMOD"), "../templates") 或传入绝对路径，别硬写相对路径。
模板中变量渲染为空，{{.Name}} 不显示数据
常见原因是传入的结构体字段未导出（首字母小写），Go 模板只能访问导出字段。比如 type User { name string } 中的 name 不会被渲染，必须写成 Name string。
另外注意传参方式：t.Execute(w, data) 中 data 必须是值或指针，但不能是 nil 指针；若用 map，键名要匹配模板中点号引用，比如 map[string]interface{}{"User": user} 对应 {{.User.Name}}。
立即学习“go语言免费学习笔记（深入）”；
- 结构体字段首字母必须大写
- 不要传
nil指针，用&user或非空 struct 实例 - map key 区分大小写，
"user"和"User"是不同键
HTML 被自动转义，{{.Content}} 显示为文字而非渲染标签
html/template 默认对所有 {{.X}} 输出做 HTML 转义，防止 XSS。若内容可信且需渲染 HTML（如后台富文本），必须显式标记为安全：
func (u *User) SafeBio() template.HTML {
return template.HTML(u.Bio)
}
// 模板里写 {{.SafeBio}}
不建议用 {{.Content | safeHTML}} 这类自定义 funcMap，容易漏判上下文；更稳妥的是在 struct 方法里封装，把信任决策留在 Go 层。
注意：template.HTML 仅绕过转义，不校验合法性 —— 若用户输入了 <script></script>，它仍会执行。真正需要富文本，得搭配 bluemonday 等库清洗后再转 template.HTML。
多个模板嵌套时，{{define}} 和 {{template}} 总是报 template: "header" not defined
问题出在模板解析顺序：每个 template.New() 创建独立作用域，ParseFiles 或 Parse 只加载当前模板树里的 define 块。正确做法是用一个主模板实例统一加载全部：
t := template.New("base")
t = template.Must(t.ParseFiles("templates/base.html", "templates/header.html", "templates/footer.html"))
// 或用 ParseGlob("templates/*.html")
确保所有 {{define "xxx"}} 在同一模板树下定义，调用时名称严格一致（含空格、引号）。子模板名不能含路径，比如 {{template "partials/header" .}} 会失败，必须是 {{template "header" .}}，且 header.html 里只含 {{define "header"}}...{{end}}，不带 {{template}} 调用自身。
调试技巧：打印 t.Templates() 查看已注册的模板名列表，确认是否漏加载或拼写错误。
go run 当前目录、结构体字段大小写、template.New 是否复用这三个位置。 
