html渲染不生效因模板未显式加载、路径相对可执行文件目录而非源码目录、后缀名非标准、字段未导出或键名不匹配；需用loadhtmlglob("templates/*/")在gin.default()后调用，c.html传参用导出结构体或严格匹配key的map。
为什么 HTMLRender 不生效？检查模板路径和后缀名
Gin 默认不自动加载 HTML 模板，必须显式调用 LoadHTMLFiles 或 LoadHTMLGlob，且模板文件路径是相对于可执行文件所在目录的——不是 main.go 所在目录，也不是 go run 的当前工作目录。常见错误是把模板放在 templates/ 下却没正确加载，或用了 .html.tpl 这类非标准后缀导致 gin.Default() 无法识别。
-
LoadHTMLGlob("templates/**/*")能匹配子目录，但必须确保通配符语法支持（Gin v1.9+ 支持双星号） - 模板中使用
{{ .Name }}传参时，结构体字段必须首字母大写（即导出字段），否则渲染为空 - 如果用
LoadHTMLFiles("templates/index.html")，文件名必须完全一致，Gin 不会自动补.html
如何让 gin.Context.HTML 正确传参并避免 panic
HTML 方法第二个参数是数据，类型为 interface{}，但实际传入 nil、未初始化 map 或字段名拼错都会静默失败或 panic。尤其当模板里写了 {{ .User.Email }} 却传了 map[string]string{"user": "alice"}，Gin 不报错，只渲染空字符串，排查困难。
- 推荐用结构体传参：
ctx.HTML(200, "index.html", struct{ Title string }{Title: "Home"}) - 若用 map，务必保证 key 名与模板中
{{ .Key }}完全一致（区分大小写），且 map 不为 nil - 模板内用
{{ if .Items }}{{ range .Items }}{{ end }}{{ end }}前，确保.Items是 slice 类型，否则range会 panic
静态资源（CSS/JS）404？别漏掉 StaticFS 配置
Gin 不会自动提供 /static/ 下的文件，必须手动挂载静态文件服务。常见错误是只写了 router.Static("/static", "./static")，但运行时当前目录不是预期位置，或路径用了绝对路径（如 /home/user/project/static）导致跨环境失效。
- 推荐用相对路径 +
os.Getwd()构造：先wd, _ := os.Getwd()，再router.Static("/static", filepath.Join(wd, "static")) -
StaticFS和StaticFile性能不同：前者适合整目录，后者适合单个文件（如 favicon.ico） - HTML 中引用路径要与路由前缀一致，比如
router.Static("/assets", "./static")，则 HTML 写<link href="/assets/main.css">
开发时热重载模板？Gin 本身不支持，得换方案
Gin 的 LoadHTML* 是启动时一次性加载，改完模板必须重启进程。没有内置热重载，强行轮询文件改动再重载容易出竞态，也不推荐自己实现。
- 开发阶段可用
gin-contrib/renders/html替代默认渲染器，它支持运行时读取模板（但性能略低，仅限 dev） - 更稳妥的做法是用
air工具监听文件变化自动重启：air -c .air.toml，配合LoadHTMLGlob实现“伪热重载” - 上线务必关掉任何动态加载逻辑，模板应打包进二进制或通过 CI 固化，避免生产环境因文件缺失或权限问题挂掉
真正麻烦的不是怎么写，而是路径在哪、谁在读、什么时候读——Gin 的模板系统很轻，但也因此把路径责任全甩给了你。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
