template.ParseFiles按进程工作目录查找文件而非源码目录，需用embed.FS或filepath.Join确保路径正确；html/template默认转义HTML，须用template.HTML类型标记安全；自定义函数需首字母大写且签名合规；嵌套模板传参时“.”代表当前上下文，传nil或错误结构体会导致panic。
template.ParseFiles 读不到文件？路径和工作目录搞混了
Go 的 template.ParseFiles 不会自动从源码所在目录找模板，它按当前进程的 工作目录（cwd） 查找。你用 go run main.go 运行时，cwd 是终端当前路径，不是 main.go 所在目录。
- 模板文件放在
./templates/index.html，但你在项目根目录外执行go run ./cmd/server，ParseFiles就会报open templates/index.html: no such file or directory - 更稳妥的做法是用
embed.FS（Go 1.16+）打包模板，或用filepath.Join拼出绝对路径 - 如果坚持用相对路径，启动前先用
os.Chdir切到代码目录（不推荐，影响其他逻辑）
tmpl, err := template.ParseFiles("templates/index.html")
// ❌ 失败常见原因：cwd 不是你想的目录html/template 自动转义后，想显示 HTML 怎么办
html/template 默认把所有变量插值当纯文本处理，{{ .Content }} 中含 <strong>hello</strong>，页面只会看到字面量，不会加粗。
- 真实 HTML 片段必须显式标记为安全：用
template.HTML类型包裹，或调用.SafeHTML方法 - 别用
strings.ReplaceAll拼 HTML 字符串再塞进去——类型不对，照样被转义 - 千万别为了“方便”换用
text/template，它不防 XSS，前端渲染任意用户输入等于开后门
type Page struct {
Content template.HTML // ✅ 正确类型
}
t.Execute(w, Page{Content: template.HTML(`<p><em>ok</em></p>`)})template.FuncMap 注册函数后不生效？大小写和命名规则卡住了
自定义函数必须满足两个硬性条件，缺一不可：
-
函数名首字母必须大写（即导出），否则
template包反射时看不到立即学习“go语言免费学习笔记（深入）”；
函数签名必须是 **func(...interface{}) (interface{}, error) 或更严格的参数/返回类型（如
func(string) string）FuncMap是 map[string]interface{}，key 是模板里用的名字，value 是函数本身；key 名可以小写，但 value 必须是导出函数常见错误：写了个
func formatTime(t time.Time) string，但没导出（小写 f），模板里调{{formatTime .Time}}直接 panic：function "formatTime" not defined另一个坑：函数返回多个值（比如
(string, error)），但没声明第二个返回值为error，template会拒绝注册
嵌套模板（define / template）传参失败？点（.）不是万能上下文
{{template "header" .}} 把当前上下文传给子模板，但 {{template "header" $}} 或 {{template "header" nil}} 会改变子模板的 . 值。
- 子模板里如果写
{{.Name}}，而你传的是nil，就会 panic：invalid memory address or nil pointer dereference - 如果只传部分字段，比如
{{template "card" .User}}，那子模板里的.就是.User，访问.Title会报错（除非User结构体里真有Title字段） - 没必要强行用
with套一层再template，直接传需要的结构体更清晰、更易测
{{define "main"}}
{{template "header" .}}
{{template "body" .Posts}} // ✅ body 模板的 . 就是 []Post
{{end}}Go 的 html/template 看似简单，但路径、类型、上下文这三块最容易在上线前夜出问题——尤其是跨环境部署时工作目录变化，和用户输入混入 HTML 片段的边界处理。
