90%的模板问题出在数据结构不匹配、模板未正确解析或混用text/template与html/template；parsefiles报“no such file”是因路径相对于运行时工作目录而非源码目录，应使用os.getwd()确认路径或改用parseglob。
html/template 是 Go 渲染 HTML 的事实标准，它默认转义变量、防 XSS，但新手常卡在解析失败、数据访问报错或 Execute 不输出上。直接说结论：**90% 的模板问题出在数据结构不匹配、模板未正确解析、或用了 text/template 渲染 HTML 内容**。
template.ParseFiles 报错 "no such file or directory"
这是最常见的一击即溃问题——Go 模板路径是相对于 运行时工作目录，不是源码目录或 main.go 所在位置。
- 用
os.Getwd()打印当前路径，确认模板文件是否真在那个位置 - 推荐改用
template.ParseGlob("templates/*.html")，它支持通配符且更容错 - 如果模板在嵌套目录（如
templates/admin/layout.html），ParseFiles必须写全路径：template.ParseFiles("templates/admin/layout.html") - 注意：Windows 路径分隔符用
/或filepath.Join，别硬写\
{{.Field}} 访问结构体字段失败或输出空字符串
Go 模板只暴露首字母大写的导出字段（exported field），且字段名必须完全匹配，大小写敏感，不支持驼峰自动转下划线。
- 结构体字段必须以大写字母开头，例如
Name string✅，name string❌（模板里取不到） - 不能用
{{.user_name}}访问UserName string；得写{{.UserName}} - 如果传的是
map[string]interface{}，key 是字符串，大小写也必须严格一致：data["Title"] = "首页"→ 模板用{{.Title}} - 嵌套字段如
{{.User.Profile.Avatar}}要求每一层都非 nil；任一层为 nil 会静默失败（输出空），建议用{{with .User}}{{with .Profile}}{{.Avatar}}{{end}}{{end}}防崩
html/template 和 text/template 混用导致 XSS 或转义异常
二者语法几乎一样，但语义完全不同：html/template 假设你渲染的是 HTML，会对所有 {{.X}} 自动转义；text/template 不转义，适合生成配置、邮件正文等纯文本。
- 渲染 HTML 页面，必须用
import "html/template"，否则<script></script>会被原样输出，有 XSS 风险 - 若你确需在 HTML 模板中插入已信任的 HTML 片段（比如富文本内容），用
{{.HTMLContent | safeHTML}}，并确保注册了safeHTML函数：FuncMap{"safeHTML": func(s string) template.HTML { return template.HTML(s) }} - 反过来，如果用
html/template渲染 JSON 或 YAML，会把{、"等符号转成{，结果非法 —— 这种场景请切回text/template
模板缓存没做，每次请求都 ParseFiles 导致性能骤降
模板解析（尤其是含嵌套 {{define}} 的）是 CPU 密集操作，绝不应在 handler 里重复调用 template.ParseFiles。
- 启动时一次性解析并复用：
var t = template.Must(template.ParseGlob("templates/**/*.html")) -
template.Must会在解析失败时 panic，比忽略 err 更早暴露问题 - 如果模板需热加载（开发阶段），可用第三方库如
github.com/rakyll/statik或自己加文件监听，但生产环境应静态编译进二进制 - 注意：
Execute是并发安全的，同一个*template.Template可被多个 goroutine 同时调用
http.ResponseWriter 一个空响应 + HTTP 200，前端看着一片白屏却收不到任何报错**。调试时务必检查 err := t.Execute(w, data) 的返回值，并记录日志。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
