根本原因是parsefiles只将首个文件作主模板名，其余文件中{{define}}块才被注册为子模板；若header.html在参数列表靠后，则其中定义的模板不会被注册。
template.ParseFiles 为什么总报 “undefined”？
根本原因不是文件没找到，而是模板名注册逻辑被误解：Go 的 template.ParseFiles 加载多个文件时，**只把第一个文件当作主模板名，其余文件里的 {{define}} 块才被当作子模板注册**。如果你在 header.html 里写了 {{define "header"}}，但调用顺序是 ParseFiles("page.html", "header.html")，那 "header" 这个名字压根不会被注册——page.html 是唯一“根名”，header.html 的内容被当作文本丢弃了。
- 确保主布局文件（如
layout.html）放在ParseFiles参数列表最前面 - 所有要复用的子模板（
header、footer、sidebar）必须用{{define "name"}}显式声明，不能靠文件名自动映射 - 更稳妥的做法是改用
template.ParseGlob("templates/**/*.html")，它不依赖加载顺序，只要文件里有{{define}}就能注册成功 - Windows 下路径分隔符容易出错，统一用
filepath.Join("templates", "header.html")替代硬写"./templates\header.html"
怎么安全输出 HTML 片段而不被转义？
html/template 默认对所有 {{.Content}} 做 HTML 转义，这是防 XSS 的核心机制；想绕过它，必须走“显式标记可信”的路径，而不是拼字符串或强转类型。
- 后端数据字段（如
BodyHTML string）必须先转成template.HTML类型：BodyHTML: template.HTML(rawString)，否则{{.BodyHTML | safeHTML}}会无效（因为safeHTML只对string类型起作用，且要求输入已为template.HTML） - 绝对不要用
strings.Replace拼接 HTML 后塞进模板——整个结果仍会被转义，<script></script>还是变成<script> -
url.QueryEscape和html.EscapeString别混用：{{.URL}}在href=""中会自动 URL 转义，{{.Title}}在标签体内会自动 HTML 转义，手动加反而可能双重编码
嵌套模板传参时数据丢失或 panic 怎么办？
常见 panic 如 reflect: Call of method on nil interface value 或渲染为空白，基本都源于上下文传递断裂或结构体字段未导出。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 结构体字段首字母必须大写（
Name✅，name❌），否则模板访问不到，且无报错，只输出空字符串 -
{{template "sidebar" .}}中的.是当前上下文，不是子模板自己的局部变量；如果子模板需要额外字段，得用{{template "sidebar" dict "User" .User "Active" "posts"}}（需提前导入text/template的dict函数） - 传入
nilslice 或nilstruct 指针会导致 panic，用{{with .Posts}}{{range .}}{{end}}{{end}}包一层可安全兜底 - 多个子模板共用函数（如时间格式化），统一通过
t.Funcs(template.FuncMap{"formatTime": formatTime})注入，避免每个模板单独定义
生产环境该用 ParseFiles 还是 ParseFS？
从 Go 1.16 开始，template.ParseFS 是更可靠的选择，尤其在构建镜像或跨平台部署时。
-
ParseFiles依赖运行时工作目录（os.Getwd()），容器里常是/或/app，路径极易错乱；而ParseFS(os.DirFS("templates"))把模板目录绑定为只读文件系统，路径始终相对于"templates" -
ParseGlob看似方便，但不保证加载顺序，若layout.html依赖_base.html里的{{define}}，而 glob 先加载了前者，就会报undefined - 预编译模板强烈建议用
template.Must包裹：tmpl := template.Must(template.New("").ParseFS(...))，开发期直接 panic 比运行时报错好 debug
真正麻烦的从来不是语法，而是模板名注册时机、字段导出规则、以及 nil 数据在嵌套中的传播方式——这些点一旦漏掉，错误往往静默发生，直到上线后用户看到空白页或脚本执行。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
