根本原因是LoadHTMLGlob使用相对于当前工作目录（os.Getwd()）的路径，而非main.go位置；应改用filepath.Dir(os.Args[0])获取源码目录构造绝对路径，并加os.Stat检查存在性，多级目录需用"templates/*/"。
router.LoadHTMLGlob("templates/*") 为什么总 panic: html/template: pattern matches no files
根本原因不是模板文件不存在，而是路径解析失败——LoadHTMLGlob 接收的是**相对于当前工作目录（os.Getwd()）** 的路径，不是相对于 main.go 文件的位置。你在 IDE 里点运行、用 go run ./cmd/server/main.go、或在父目录执行命令，os.Getwd() 值完全不同，导致 "templates/*" 找不到任何文件。
常见错误现象：panic: html/template: pattern matches no files，但 ls templates/ 确实有文件；go run main.go 在项目根目录下能跑，换到 ./cmd/ 下执行就挂。
- 永远别用相对路径硬编码，比如
router.LoadHTMLGlob("templates/*") - 用
filepath.Abs动态算出模板目录绝对路径：先获取main.go所在目录（filepath.Dir(os.Args[0])更可靠，比os.Getwd()不受启动位置影响） - 构造路径后务必加存在性检查：
os.Stat(tmplDir)，避免静默失败 - 多级子目录要显式支持：用
"templates/**/*"而非"templates/*"，否则templates/components/header.tmpl不会被加载
LoadHTMLGlob 和 LoadHTMLFiles 参数差异与适用场景
LoadHTMLGlob 是通配符批量加载，LoadHTMLFiles 是显式列举文件列表，二者底层都调用 template.ParseGlob 或 template.ParseFiles，但行为边界很不同。
使用场景差异：
- 开发期快速迭代：用
LoadHTMLGlob("templates/**/*")，改完模板不用改代码 - 生产环境精简体积：用
LoadHTMLFiles("templates/index.tmpl", "templates/user/profile.tmpl")，只加载真实用到的模板，避免误加载测试文件或废弃片段 - 模板名含特殊字符（如
user-v1.tmpl）：通配符可能漏匹配，此时必须用LoadHTMLFiles显式传入 - 嵌入式编译（
//go:embed）不支持LoadHTMLGlob，只能用LoadHTMLFiles配合embed.FS读取内容再template.New().Parse
模板路径中 “/” 和 “.” 的陷阱：为什么 c.HTML(http.StatusOK, "index.tmpl", ... ) 找不到文件
c.HTML 第二个参数是模板名（name），不是磁盘路径。它必须和 LoadHTMLGlob 解析出的模板文件名完全一致——包括扩展名、大小写、子目录层级。
例如你用 router.LoadHTMLGlob("templates/**/*") 加载了 templates/pages/home.tmpl，那么 c.HTML 必须写 "pages/home.tmpl"，不能写 "home.tmpl" 或 "templates/pages/home.tmpl"。
- 模板名中不能带前导
/（如"/pages/home.tmpl"会报错） - 子目录名区分大小写：Linux/macOS 下
"Pages/home.tmpl"≠"pages/home.tmpl" - 如果模板实际在
templates/admin/dashboard.html，但LoadHTMLGlob("templates/*.html")只扫一级，那"admin/dashboard.html"永远不会被注册，c.HTML就必然template: "admin/dashboard.html" is undefined
静态资源与模板共存时 CSS/JS 路径 404 的根源
模板里写的 <link href="/css/app.css"> 能否加载成功，和 router.Static("/css", "./static/css") 的配置强相关，但关键不在 Gin，而在三者是否对齐：
- 浏览器请求的 URL 路径（
/css/app.css） - Gin
Static的 URL 前缀（/css）和本地磁盘路径（"./static/css"）拼接逻辑 - HTML 中引用路径是否与前端构建产物结构一致（比如 Vite 默认输出到
dist/assets/，而非dist/css/）
最容易被忽略的一点：如果你把 CSS 放在 templates/css/ 下，并用 r.Static("/css", "templates/css")，那 HTML 中必须用 /css/app.css；但若模板本身也放在 templates/ 下，很多人会误以为“同目录”，直接写 css/app.css（相对路径），结果浏览器发请求变成 /pages/css/app.css，彻底走错路由。
