Gin中正确渲染HTML模板需确保三者对齐：LoadHTMLGlob路径匹配（如"templates/*/"支持子目录）、模板名与{{define "xxx"}}声明一致、数据字段首字母大写且c.HTML传入匹配名称。
模板页面在 Gin 中不是“写完就能用”，关键在于加载时机、路径匹配和数据传递三者必须对齐，否则 c.HTML 会静默失败或报 template: "xxx" is undefined 错误。
模板文件路径与 LoadHTMLGlob 的匹配逻辑
Gin 不会自动递归扫描子目录，LoadHTMLGlob("templates/*") 只加载 templates/ 下的**一级文件**，遇到 templates/admin/index.html 就直接忽略。常见错误是开发者把模板按功能分目录（如 templates/blog/、templates/user/），却仍用单星号加载。
-
LoadHTMLGlob("templates/**/*")才能匹配多级子目录中的所有.html或.tmpl文件 - 通配符
**必须紧挨着/，写成templates/**.html是无效的 - 如果只加载固定几个模板，用
LoadHTMLFiles("templates/layout.html", "templates/home.html")更明确、启动更快 - 模板文件名中的点（如
user.profile.html）会被 Gin 当作模板名的一部分，c.HTML(200, "user.profile.html", data)是合法的
c.HTML 渲染时的模板名必须与 define 块一致
Gin 的 c.HTML 第二个参数是模板名，它不等于文件路径，而是文件内 {{ define "xxx" }} 声明的名称。很多人把文件名当模板名传，结果渲染空白页且无报错。
- 若
templates/blog/list.html内容以{{ define "blog-list" }}开头，则必须调用c.HTML(200, "blog-list", data) - 如果没写
{{ define ... }}，Gin 会默认使用文件路径作为模板名（如"blog/list.html"），但这种隐式行为不可靠，尤其在嵌套{{ template }}时容易出错 - 推荐统一显式定义：每个模板文件开头都加
{{ define "xxx" }}，结尾加{{ end }}，避免歧义
动态内容渲染中容易被忽略的转义与安全边界
Go 的 html/template 默认对所有变量输出做 HTML 转义，这是安全机制，但也是新手最常卡住的地方——比如想渲染一段带 <script></script> 的富文本，结果看到的是纯文本。
- 用
{{ .Content | safeHTML }}解除转义，但仅限你**完全信任该数据来源**（如后台管理员输入） - 自定义函数更可控：在
r.SetFuncMap()中注册一个清洗函数，比如"clean": func(s string) template.HTML { return template.HTML(stripTags(s)) } - 不要在模板里拼接 URL 参数或 JS 变量，应由 Go 层处理好再传入，例如：
href="/post/{{.ID}}"安全，但onclick="goTo({{.ID}})"可能因未转义引号而破坏 HTML 结构 - 时间格式化必须用双引号包裹布局字符串：
{{ .Time.Format "2006-01-02" }}，漏掉引号会编译失败
嵌套模板中 base.html 与子模板的数据传递
使用 {{ template "header" . }} 时，那个 . 是当前作用域的完整数据，但子模板（如 header.html）内部无法直接访问父模板里未显式传递的字段，除非你把整个上下文透传过去。
- 基础模板
base.html中定义{{ define "base" }}...{{ template "content" . }}...，子模板必须用{{ define "content" }}且接收. - 如果子模板需要额外字段（如
.SiteTitle），但主数据结构里没有，要么在渲染时补全：c.HTML(200, "home", gin.H{"SiteTitle": "MyBlog", "Posts": posts})，要么用with块限定作用域 -
{{ template "sidebar" (dict "User" .User "OnlineCount" 123) }}这种显式构造 map 的方式比依赖全局.更清晰、易测
