Go 的 html/template 通过 define/template + ParseFiles 实现模板复用，需确保所有模板在同个实例中按依赖顺序加载，显式传参防冲突，注入静态前缀和路由URL避免硬编码。
Go 的 html/template 本身不支持“组件化”或“嵌套作用域复用”，所谓“模板复用”实际是靠 define/template + ParseFiles 配合文件拆分实现的，不是像 React/Vue 那样的运行时复用。
如何用 define 和 template 复用页面区块
核心是把共用结构（如页头、页脚、侧边栏）单独定义为命名模板，再在主模板中调用。注意：所有被复用的模板必须在同一个 template.Template 实例中解析，否则 template "xxx" 会报 template: xxx is not defined。
- 每个
define块必须有唯一名称，且不能含空格或特殊字符（推荐全小写+下划线） -
template调用时默认继承当前数据上下文；若需传入新数据，用{{template "name" .SomeField}}或{{template "name" (dict "Title" "Home" "User" .User)}}（需配合text/template的dict函数，html/template默认不提供，得自己注册） - 多个模板文件需用
ParseFiles一次性加载，不能先 Parse 一个再 Load 另一个
func main() {
t := template.Must(template.New("").ParseFiles(
"layout.html",
"header.html",
"footer.html",
"home.html",
))
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
data := struct{ Title string }{"Home Page"}
t.ExecuteTemplate(w, "home.html", data)
})
}
为什么 ParseGlob 容易导致复用失败
ParseGlob("templates/*.html") 看似方便，但实际按文件字典序加载——如果 header.html 在 home.html 之后被解析，而 home.html 里写了 {{template "header"}}，就会因未定义报错。
- 解决办法：显式控制加载顺序，用
ParseFiles列出所有依赖文件，把被引用的（如header.html）放在前面 - 或者统一用一个大模板文件，用
define分区，避免跨文件依赖 - 注意：Go 1.22+ 的
template.ParseFS支持embed.FS，但同样要求所有模板在 FS 中存在且能被一次性发现，顺序问题依然存在
如何安全地传递不同数据给复用模板
直接传 . 容易造成字段冲突或 XSS 风险（比如页头需要 .User.Name，但页脚只需要 .Copyright）。推荐封装结构体或用 map[string]interface{} 显式透传。
立即学习“go语言免费学习笔记（深入）”；
- 避免在
header.html里写{{.User.Email}}，而主模板没传User字段——这会静默渲染为空，难调试 - 更健壮的做法：定义接口或结构体，让模板编译期报错，例如：
type LayoutData struct { Title string User *User IsLoggedIn bool }然后统一传LayoutData，各子模板只访问明确字段 - 若必须动态字段，用
{{with .HeaderData}}{{.Title}}{{end}}包一层，防止 nil panic
静态资源路径和 URL 构造容易被忽略
复用模板里常要写 <link href="/static/css/app.css">，但部署到子路径（如 /myapp/）时会 404。Go 模板本身不处理路由前缀，得靠外部注入。
- 不要硬编码
/static/，改用{{.StaticPrefix}}/css/app.css，启动时根据环境注入StaticPrefix: "/myapp/static" - 生成链接时别用
/post/123，改用{{.Router.URL "post.show" "id" "123"}}（需集成gorilla/mux或自定义 URL 生成器） - HTML 模板里无法执行
url.Parse，所有路径逻辑必须在 handler 层准备好再传入
真正麻烦的不是语法，而是数据流设计：哪个模板该信任谁的数据、错误时是否静默失败、部署路径变化时哪几处要改——这些没法靠 template 包自动解决。
