gin 默认不递归查找子目录，需用loadhtmlglob("templates/*/")或平铺模板；结构体字段须首字母大写才可渲染；开发时应启用debugmode禁用模板缓存。
为什么 Gin 的 HTMLRender 默认不自动查找子目录
直接调用 c.HTML(200, "index.html", nil) 却报错 template: "index.html" is undefined，大概率是因为模板路径没配对。Gin 默认只从 ./templates（当前工作目录下的 templates 文件夹）加载，且不会递归扫描子目录。比如你把文件放在 templates/pages/index.html，Gin 就找不到它——除非显式注册时带上完整路径名。
实操建议：
- 把所有 HTML 文件平铺放在
./templates/下，例如./templates/index.html、./templates/user_list.html - 若必须用子目录结构，注册模板时得手动 glob 匹配：
engine.LoadHTMLGlob("templates/**/*")（注意：Gin 1.9+ 支持双星号，旧版本只能写成templates/*/*.html） - 启动前加一句日志确认是否加载成功：
log.Println("loaded templates:", engine.HTMLRender.(*gin.HTMLRender).Templates.Templates())
如何在模板里安全传入并使用结构体字段
Gin 传数据靠 c.HTML() 第三个参数，但 Go 模板对字段可见性敏感：只有首字母大写的导出字段才能被渲染。传一个 user := struct{ Name string }{"Alice"}，模板里写 {{.Name}} 没问题；但要是写成 name string，就输出空字符串，且不报错，极难排查。
常见错误现象：
- 模板中
{{.ID}}显示为空，检查结构体字段是否为ID int（✅）还是id int（❌） - 嵌套结构体字段如
{{.Profile.AvatarURL}}，需确保Profile和AvatarURL都是导出字段 - 想传 map 或 slice？可以，但 map key 必须是可比较类型（string/int 等），且模板内访问用
{{index .Users 0}}或{{.Users.key}}（key 为 string）
template.ParseFiles 和 LoadHTMLGlob 选哪个
本质区别在于模板注册时机和灵活性：LoadHTMLGlob 是 Gin 封装的便捷方法，在启动时一次性加载匹配的所有文件；而手动用 template.ParseFiles 可以动态加载、热更新（比如开发时监听文件变化后重新 parse），但要自己管理 *template.Template 实例并注入到 Gin 引擎。
前端设计质量提升 skill。让 AI 生成的 UI/前端代码更专业，避免常见设计反模式。 参考 impeccable 项目的设计语言规范，提供 audit/polish/critique 等设计审查命令。 触发词：/audit /polish /critique /colorize /animate /bold...
使用场景建议：
- 生产环境、静态页面为主 → 用
router.LoadHTMLGlob("templates/*.html")，简单可靠 - 需要局部刷新某个模板（如 CMS 后台编辑模板后实时生效）→ 自建
template.New("").ParseFiles(...)，再调用engine.SetHTMLTemplate(yourTpl) - 混合使用静态页 + 邮件模板？别共用同一
HTMLRender，邮件模板建议单独用text/template，避免 HTML 转义干扰
为什么修改了 HTML 文件却看不到效果
不是浏览器缓存，是 Gin 默认开启了模板缓存 —— 它在第一次调用 LoadHTMLGlob 时解析并复用内存中的 template 实例，后续文件变更完全不感知。开发阶段必须关掉这个缓存，否则改完保存等于白改。
解决方式很直接：
- 开发时启用自动重载：
router.Delims("{[{", "}]}") // 可选：换 delims 避免和 JS 冲突+router.LoadHTMLGlob("templates/**/*")，然后确保没设GIN_MODE=release - 更稳妥的做法：启动前加
gin.SetMode(gin.DebugMode)，此时 Gin 会自动禁用模板缓存 - 如果用了
LoadHTMLFiles或手动ParseFiles，就得自己实现文件监听（例如用fsnotify），并在变更时重新ParseFiles并SetHTMLTemplate
真正容易被忽略的是：有些 IDE（如 VS Code）在保存文件时可能触发“原子写入”，导致短暂出现文件不存在的竞态，Gin 模板 loader 遇到读取失败会静默跳过该文件，而不是报错——所以改完没反应，先检查 templates 目录下文件是否真的已落盘。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
