Gin模板加载路径以二进制所在目录为基准，需用LoadHTMLGlob并确保在gin.Default()后、路由前调用；静态资源需显式配置router.Static；数据传入须字段导出且键名严格匹配。
模板文件找不到：Gin 的 LoadHTMLFiles 路径是相对二进制运行位置的
Gin 不会自动从源码目录或 go run 当前路径加载模板，而是以最终生成的可执行文件所在目录为基准。你用 go run main.go 时，工作目录可能和预期不一致；但编译成二进制后，./myapp 运行时若不在模板同级目录，LoadHTMLFiles("templates/index.html") 就会静默失败（无 panic，但渲染返回空）。
实操建议：
- 统一用
LoadHTMLGlob("templates/**/*")，比逐个列文件更可靠，也避免漏加新模板 - 启动时加一行日志：
log.Println("loading templates from:", "templates/**/*")，确认路径意图明确 - 如果必须用子目录结构，确保打包部署时把
templates/目录完整复制到二进制同级，而不是只扔一个 binary 上去 - 开发期可临时用
os.Chdir("path/to/your/project")强制切换工作目录（仅调试，勿进生产）
Gin 渲染 HTML 时提示 template: "index" is undefined
这不是文件没找到，而是模板未被正确解析注册。Gin 的 LoadHTMLFiles 或 LoadHTMLGlob 必须在 gin.Default() 之后、路由注册之前调用，否则引擎内部的 template map 没初始化好，文件读了也白读。
常见错误写法：
立即学习“go语言免费学习笔记（深入）”；
router := gin.Default()
// ❌ 错：这里还没加载模板，但下面马上用了 HTML 渲染
router.GET("/", func(c *gin.Context) {
c.HTML(200, "index.html", nil)
})
// ✅ 对：加载必须在这之前
router.LoadHTMLGlob("templates/**/*")
另外注意文件名和 c.HTML 第二个参数要严格匹配——c.HTML(200, "index.html", ...) 要求模板名就是 "index.html"，不是 "index"；如果你用 LoadHTMLGlob("templates/*.html")，那模板名就是不含路径的文件名（含 .html 后缀）。
静态资源（CSS/JS）404：Gin 默认不自动服务 static/ 目录
HTML 页面里写了 <link href="/css/app.css">，但浏览器打开直接 404，不是路径写错，是 Gin 根本没配置静态文件处理器。
实操建议：
- 加一行
router.Static("/static", "./static")，让/static/xxx映射到本地./static/xxx - HTML 中引用路径要和注册的 URL 前缀一致：用
/static/css/app.css，别写css/app.css（相对路径在 HTML 里由浏览器解析，容易错乱） - 如果项目结构是
templates/和public/并列，那就router.Static("/static", "./public")，保持语义清晰 - 不要把静态文件塞进
templates/目录下——Gin 的模板加载机制不会处理它们，还可能误解析出错
HTML 模板里用 {{.Title}} 渲染空白：数据传入格式不对
Gin 的 c.HTML 第三个参数必须是能被 text/template 正确取值的结构。传 map[string]interface{} 可以，但 key 名必须和模板里 {{.Key}} 完全一致（大小写敏感），且不能是 nil。
典型问题：
- 传了
map[string]string{"title": "Home"}，但模板写{{.Title}}→ 匹配不到，输出空 - 传了 struct 但字段没导出（小写开头）：如
type Page struct { title string }→ 模板无法访问任何字段 - 传了
nil或空map，模板里{{.Title}}不报错，只是不显示
安全写法示例：
type PageData struct {
Title string
Items []string
}
c.HTML(200, "index.html", PageData{
Title: "Dashboard",
Items: []string{"a", "b"},
})
这样字段可导出、类型明确、不易拼错。
模板路径、模板名、数据结构三者对不上，是 HTML 渲染失败最常卡住的地方。尤其上线前打包，很容易只拷了 binary，忘了同步templates/ 和 static/ 目录。 
