Gin中html/template嵌套模板最直接方式是用{{define}}声明子模板、{{template}}显式调用，所有模板须一次性ParseGlob加载，主模板通过{{template "name" .}}注入header/footer等公共部分，避免单独解析导致“not defined”错误。
用 html/template 的嵌套模板（{{define}} + {{template}}）最直接
Gin 默认使用 Go 原生的 html/template，不内置布局继承机制，但完全支持模板嵌套。核心是：在主模板中用 {{template "name" .}} 调用已定义的子模板，而子模板用 {{define "name"}}...{{end}} 声明。
常见错误是把 header.html 和 footer.html 当作独立可执行模板去 ParseFiles，结果渲染时报 template: "header.html" is not defined —— 因为 Gin 的 HTML() 方法只认你显式传入的主模板，其他模板必须和它一起被 ParseGlob 或 ParseFiles 加载。
- 所有模板文件（
layout.html、header.html、content/index.html等）必须一次性加载，例如：tmpl := template.Must(template.ParseGlob("templates/**/*")) -
layout.html中用{{define "layout"}}包裹整体结构，并用{{template "header" .}}和{{template "footer" .}}插入公共部分 - 具体页面模板（如
index.html）里先{{define "content"}}，再在layout.html的{{template "content" .}}位置被注入
为什么不用 {{block}}？Gin 不支持 Laravel 那种 Blade 式语法
{{block}} 是 html/template 的扩展语法，Go 标准库原生不识别；Laravel 的 @yield、ThinkPHP 的 {% block %} 都是各自模板引擎实现的，Gin 没做这层封装。硬写 {{block "title" .}}{{end}} 会直接报错 undefined: "block"。
替代方案只有两种：一是用 {{define}}/{{template}} 手动组织父子关系；二是引入第三方模板引擎（如 pongo2），但会增加依赖且破坏 Gin 的轻量定位。
- 如果你习惯 Blade 风格，
pongo2支持{% extends "base.html" %}，但需手动注册到 Gin：engine.AddFunc("render", ...) - 绝大多数生产项目仍用原生
html/template，因为够用、无额外 runtime 开销、调试链路清晰
路由 handler 中怎么正确传参给公共模板？
头部常需动态数据（如用户登录态、当前菜单高亮），尾部可能要插入统计脚本或版本号。这些不能写死在 header.html 里，得靠 .（即传入的 data map）传递。
容易踩的坑是：在 handler 里只传了 map[string]interface{}{"Title": "首页"}，但 header.html 里写了 {{.User.Name}}，运行时 panic：nil pointer evaluating interface {}.Name。
- 统一用 struct 传参比 map 更安全，例如
type PageData struct { Title string; User *User; Scripts []string } - 在
header.html中加保护判断：{{if .User}}欢迎 {{.User.Name}}{{else}}请登录{{end}} - 避免在公共模板里访问未声明字段，否则整个页面渲染失败
静态资源路径在不同模板间怎么保持一致？
比如 header.html 引了 /css/app.css，footer.html 引了 /js/analytics.js，但部署到子路径（如 https://example.com/admin/）时，这些路径会 404。
Go 模板没有类似 Laravel 的 asset() 辅助函数，得自己处理：
- 在 PageData struct 中预计算完整 URL：
CSSURL: "/admin/css/app.css"，然后{{.CSSURL}} - 或用中间件注入 base path 到 context，再通过自定义 template func 提取：
func (c *gin.Context) BasePath() string { return c.GetString("base_path") }，但需注册为 template func - 更简单的是：前端用相对路径（
./css/app.css）+ 正确设置<base href="/admin/">，由浏览器自动补全
真正难处理的不是路径拼接，而是当多个团队共用同一套 header.html 时，有人悄悄加了 async 属性，有人删了 integrity，没人知道改动影响范围 —— 这类问题只能靠 CI 阶段的 HTML lint 和 diff review 来兜底。
