{{.}} 不会自动穿透到子模板，必须显式传参；调用 {{template "name"}} 时不传第二个参数会导致子模板中 {{.}} 为空，应写为 {{template "nav" .}} 或用 dict 传递部分字段，$ 和 {{$}} 均无法跨 template 边界访问父级上下文。
{{.}} 不会自动穿透到子模板，必须显式传参。
子模板调用父级数据时 {{.}} 为空的原因
Gin 使用 Go 原生 html/template，而 {{template "name"}} 默认不继承调用方的上下文。如果写成 {{template "nav"}}（没传第二个参数），子模板收到的 . 就是空结构体 struct{}，不是你传给主模板的 gin.H{"title": "xxx"}。
这和你是否用了 gin.H、map[string]interface{} 或结构体无关——根本问题在于调用语法漏了数据传递。
- 必须写成
{{template "nav" .}}，让子模板拿到当前上下文 - 如果只传部分字段，比如只传导航需要的
.user和.path，就写{{template "nav" dict "user" .user "path" .path}}（前提是已注册dict函数） - 不要依赖
{{$}}在子模板里“向上找”，它只在当前模板作用域有效，进不了{{template}}创建的新作用域
{{$.xxx}} 在子模板里无效
$ 是当前模板顶层上下文的别名，但它不会跨 {{template}} 边界。也就是说：
主模板里
{{$.title}}能取到gin.H{"title": "Home"}但进了
{{template "nav" .}}后，{{$.title}}还是报错或为空，因为$指向的是子模板自己的顶层（即你传进去的那个.），不是原始主模板的顶层正确做法：确保传入子模板的数据包含所需字段，例如
{{template "nav" .}}，然后子模板直接用{{.title}}若主模板传的是结构体，且字段未导出（小写开头），子模板也读不到——Go 模板只能访问首字母大写的字段
多层嵌套时怎么避免重复传参
比如 index.html → nav.html → user-menu.html，每层都手动写 {{template "user-menu" .}} 很累，还容易漏。
- 推荐统一用一个顶层数据结构，比如
PageData结构体，把所有页面级字段（Title、User、Path、CSRF等）都定义为导出字段 - 所有
{{template}}调用统一传.，子模板按需取字段，不用记谁传了什么 - 避免在模板里拼接数据（如
{{dict "title" .Title "user" .User}}），这种逻辑应前置到 handler 中组装好再传
容易被忽略的坑：函数注册不影响数据作用域
有人试过用 router.SetFuncMap() 注册一个 getNavData 函数，想在子模板里调用它“拿回父数据”。这是徒劳的——函数内部拿不到调用它的模板上下文，getNavData 收到的参数仍是子模板的 .，不是父模板的。
- 模板函数不能绕过作用域隔离，它只是个纯函数调用
- 所有依赖上下文的逻辑，必须靠显式传参解决
- 如果真需要动态计算（比如根据
.path渲染不同菜单），就把计算逻辑写在 handler 里，算好结果塞进数据结构再传下去
传参这件事，没有捷径。漏一次 .，子模板就丢数据；字段没导出，模板就静默失败；嵌套深了还想着靠 $ 或函数“捞数据”，只会浪费调试时间。
