90%的Go模板渲染失败源于路径错误、结构体字段未导出或混用text/template与html/template；ParseFiles报“no such file”因路径相对于os.Getwd()返回的工作目录，需用ParseGlob或全路径并确保字段首字母大写、大小写严格匹配。
Go 模板文件渲染失败，90% 是因为路径错、结构体字段没导出、或用错了 template 包 —— 不是语法问题，是运行时上下文和类型约束没对上。
template.ParseFiles 报 “no such file or directory” 怎么查
Go 的模板路径永远相对于 os.Getwd() 返回的当前工作目录，不是 main.go 所在位置，也不是编译后二进制所在目录。
- 加一行
fmt.Println("cwd:", os.Getwd())确认实际路径，再看模板文件是否真在那个位置 - 用
template.ParseGlob("templates/*.html")替代硬写一堆文件名，它自动匹配、容错强、不依赖顺序 - 如果模板在子目录（如
templates/admin/layout.html），ParseFiles必须写全路径：template.ParseFiles("templates/admin/layout.html") - Windows 下别手写
\，统一用/或filepath.Join("templates", "index.html")
{{.Field}} 访问结构体字段为空或 panic
模板只认首字母大写的导出字段，且大小写、拼写必须完全一致；任何一层为 nil 都静默输出空字符串，不会报错。
- 结构体字段必须大写开头：
Name string✅，name string❌（模板里取不到） -
{{.user_name}}永远取不到UserName string，得写{{.UserName}} - 嵌套访问如
{{.User.Profile.Avatar}}，要求User、Profile都非nil；建议用{{with .User}}{{with .Profile}}{{.Avatar}}{{end}}{{end}}防崩 - 传
map[string]interface{}时，key 名也要严格匹配：data["Title"] = "首页"→ 模板写{{.Title}}
html/template 和 text/template 混用导致内容异常
二者语法一样，但语义完全不同：一个默认转义防 XSS，一个完全不转义。选错就等于主动开后门或破坏格式。
立即学习“go语言免费学习笔记（深入）”；
- 渲染 HTML 页面，必须用
import "html/template"；用text/template会导致<script></script>原样输出，有 XSS 风险 - 想插入已信任的 HTML（比如富文本），注册自定义函数：
FuncMap{"safeHTML": func(s string) template.HTML { return template.HTML(s) }}，模板里写{{.Content | safeHTML}} - 反过来，用
html/template渲染 JSON/YAML 会把{、"转成{、"，结果非法 —— 这种场景请切回text/template
多模板复用时 ExecuteTemplate 不生效
用 ParseGlob 加载多个文件后，模板引擎并不知道哪个是主入口；Execute 默认执行根模板（第一个解析的），不是你想要的那个。
- 每个模板文件开头必须用
{{define "xxx"}}显式命名，例如base.html里写{{define "base"}} - 在其他模板中用
{{template "base" .}}引入，注意传参用.表示当前数据上下文 - 执行时用
t.ExecuteTemplate(w, "index", data)，第二个参数是{{define}}里的名字，不是文件名 - 避免在每次 HTTP 请求里重复调用
ParseGlob，应在程序启动时一次性解析并缓存*template.Template实例
最常被忽略的是：模板解析成功 ≠ 数据能取到；Execute 返回 nil 也不代表渲染成功 —— 它可能只是静默跳过 nil 字段或未导出字段。调试时优先打日志确认当前工作目录、结构体字段导出状态、以及实际传入的数据结构是否符合模板预期。
