HTML模板返回空白或404，是因为Gin默认不自动查找模板文件，必须在gin.Default()之后、r.Run()之前调用LoadHTMLGlob或LoadHTMLFiles加载模板，否则c.HTML会静默失败（返回空响应但状态码仍为200）；模板名须与加载路径完全一致（不含路径和扩展名），且数据结构字段需导出，静态路由前缀应与模板路径无交集。
为什么 HTML 模板返回空白或 404？
Gin 默认不自动查找模板文件，LoadHTMLGlob 或 LoadHTMLFiles 必须在路由注册前调用，否则所有 c.HTML 都会静默失败（返回空响应，状态码仍是 200）。常见错误是把模板加载写在 main() 末尾、或放在某个 handler 里——这毫无作用。
- 必须在
gin.Default()或gin.New()之后、r.Run()之前执行 - 路径是相对于可执行文件所在目录的，不是
go run所在路径；交叉编译时尤其要注意 -
LoadHTMLGlob("templates/**/*")不能匹配隐藏文件（如.html），也不支持嵌套通配符深度限制
c.HTML 的 status code 和 data 怎么设才安全？
c.HTML 第一个参数是 HTTP 状态码，第二个是模板名（不含路径和扩展名），第三个是传入的数据。很多人直接传 nil 或字面量 map，但实际项目中容易因字段缺失 panic —— Gin 不做字段存在性检查，模板里引用不存在的字段会直接报错并返回 500。
- 模板名必须与
LoadHTMLGlob加载到的文件名完全一致（不含路径、不含扩展名），例如templates/user/index.html对应模板名"user/index" - 推荐用结构体传参而非 map，便于 IDE 提示和编译期检查；字段需导出（首字母大写）
- 状态码别硬写
200，比如表单提交后重定向失败，该返回422就别用200+ 错误提示塞进模板
c.HTML(http.StatusOK, "admin/dashboard", DashboardData{
Title: "控制台",
Users: users,
})
静态资源和模板路径冲突怎么破？
Gin 的 r.Static 和模板路径都依赖文件系统，若静态目录（如 public/）和模板目录（如 templates/）有同名子目录，且路由没写全，就可能意外命中静态文件而跳过模板渲染。最典型的是：你访问 /login，结果返回了 public/login.html 而不是 templates/login.html。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 确保
r.Static的 URL 前缀（如"/static"）和模板路由无交集 - 避免把模板文件放在
public/或static/目录下——Gin 不区分“模板”和“静态”，只看路径匹配顺序 - 调试时加个中间件打印
c.Request.URL.Path和c.HandlerName()，确认走的是哪个 handler
热加载模板在开发环境怎么做？
Gin 本身不支持模板热重载，每次改 HTML 都要重启进程。官方不提供内置方案，但可以用 fsnotify 监听文件变化后重建引擎——不过注意：Gin 的 HTMLRender 是只读的，无法运行时替换，只能重启或重建 *gin.Engine 实例，后者成本高且破坏连接状态。
立即学习“go语言免费学习笔记（深入）”；
- 简单方案：开发时用
gin.SetMode(gin.DebugMode)，配合go run+air工具自动重启（air默认监听.html文件） - 不要在生产环境启用任何热加载逻辑，模板应随二进制一起打包（用
embed或packr） - 如果坚持自己实现监听，务必在重载时加锁，避免并发调用
c.HTML时 render 引擎被替换成一半的状态
c.HTML 就可能悄无声息地失效。线上跑着跑着突然白屏，八成是模板路径变了或者 LoadHTMLGlob 被挪到了错误位置。 
