ParseFiles 报错因路径基于 os.Getwd() 而非源码目录；模板字段须导出（首字母大写）；HTML 输出需 template.HTML 或 safeHTML；嵌套模板名须严格一致；推荐 embed.FS 和 ParseGlob。
template.ParseFiles 报 “no such file or directory”？默认路径不是代码目录，而是 os.Getwd() 返回的当前工作目录——本地 go run 可能碰巧对了，CI 或 Docker 容器里必然失败。
ParseFiles 路径错在哪？
Go 模板加载不认“项目根目录”或“源文件所在目录”，只认进程启动时的当前工作目录。比如你从 /home/user/myapp 下执行 go run main.go，ParseFiles("templates/index.html") 就会去这个路径下找，而不是 main.go 所在目录下的 templates/。
- 调试时先加两行：
fmt.Println("cwd:", os.Getwd())和abs, _ := filepath.Abs("templates/index.html"); fmt.Println("abs:", abs)，确认文件真存在 - 可靠写法是用
filepath.Join(filepath.Dir(runtime.Caller(0)), "templates", "index.html")拿到源码相对路径 - 更现代、更安全的做法：把模板放进
embed.FS（Go 1.16+），改用template.ParseFS(fs, "templates/*.html")
Execute 总 panic "cannot return value from unexported field"
这不是模板语法问题，是 Go 的反射规则：模板只能访问结构体中首字母大写的导出字段。哪怕 JSON tag 写了 json:"age"，只要字段名是 age int（小写），{{.age}} 就直接 panic。
- 检查所有传入模板的数据结构，把
name string改成Name string - 别依赖 IDE 自动生成的 struct；反序列化 JSON 后，用
fmt.Printf("%#v", data)看实际暴露的字段 - 临时绕过：用
map[string]interface{}传值，或加 Getter 方法（如Age() int { return u.age }），模板里调{{.Age}}
HTML 标签被当成纯文本显示？
这是 html/template 的默认保护行为：所有 {{.Content}} 输出都会自动转义 、<code>> 等字符。你看到 <h1>Hello</h1>，说明内容被当作文本渲染了。
- 如果
.Content是可信 HTML（比如 CMS 后台编辑的富文本），用{{.Content | safeHTML}}显式标记 - 确保变量类型是
template.HTML，比如data := struct{ Content template.HTML }{Content: `<b>Hello</b>`} - 千万别用
strings.ReplaceAll去“手动解码”转义结果——这会破坏其他本该转义的内容（比如用户昵称里的<script>） - 生成非 HTML 内容（如邮件正文、JSON、SQL）请用
text/template，避免转义干扰格式
嵌套模板 {{define}} 不生效？
{{define "header"}} 和 {{template "header" .}} 名字必须完全一致：大小写、空格、斜杠都不能差。拼错就静默输出空内容，无报错。
立即学习“go语言免费学习笔记（深入）”；
- 用
tmpl.Templates()查看已加载的所有模板名，每个都调.Name()确认拼写 -
ParseFiles加载多个文件时，第一个文件名成为主模板名，其余文件里的{{define}}块才被注册为子模板 - 推荐统一用
template.ParseGlob("templates/**/*.html")，再配合{{template "header" .}}，避免漏加文件
safeHTML 不校验内容合法性、以及 range 遇到 nil 切片会 panic —— 这些错误都不报明确提示，只在渲染时突然崩掉。写完模板，务必用边界数据（nil slice、空 map、含特殊字符的字符串）跑一遍。 
