在Go语言Gin框架Web开发中，LoadHTMLGlob是批量加载HTML模板、实现动态页面渲染的核心方法，也是新手最容易踩坑的节点。尤其在Windows系统开发环境下，极易出现panic: html/template: pattern matches no files: templates/**/*``的崩溃报错，本文结合实际报错案例，拆解问题根源、梳理跨平台路径规则、提供完整可落地的解决方案，同时厘清LoadHTMLGlob与r.Static、c.HTML的核心关系，帮开发者彻底避开路径匹配陷阱。

一、报错现象与核心问题还原

开发者在Windows PowerShell环境运行Gin项目，代码中使用r.LoadHTMLGlob("templates/**/*")加载多级目录HTML模板，启动程序直接抛出恐慌异常，程序终止运行。报错核心含义为：模板匹配规则未找到任何匹配的HTML文件。

很多开发者会困惑，该写法在Linux、MacOS系统可正常运行，唯独Windows环境失效，本质是通配符语法跨平台不兼容导致的。

二、报错根本原因解析

Gin的LoadHTMLGlob底层依赖Go标准库filepath.Match实现文件匹配，而该库对通配符的支持存在系统差异：

1. Linux/MacOS系统：原生支持**递归通配符，templates/**/*可匹配templates目录下所有层级的HTML文件，适配多级子目录；
2. Windows系统：filepath.Match不识别**双层递归通配符，该语法在Windows环境直接失效，无法扫描子目录文件，系统判定无匹配文件，直接触发panic崩溃；
3. 额外诱因：Windows默认路径分隔符为反斜杠\，Gin统一使用正斜杠/，若手动混用路径符号，也会加剧匹配失败问题。

三、分场景正确路径写法（Windows专用，直接复制可用）

结合项目目录结构，分3种场景提供适配写法，同时兼顾跨平台兼容性：

场景1：模板仅在templates一级目录（无子文件夹）

目录结构：

项目根目录
├─main.go
└─templates
    └─index.html

正确代码：

r.LoadHTMLGlob("templates/*")

仅匹配一级目录下所有文件，Windows、Linux通用。

场景2：模板包含二级子目录（最常用，如admin子文件夹）

目录结构：

项目根目录
├─main.go
└─templates
    ├─index.html
    └─admin
        └─dash.html

Windows正确写法（二选一）：

// 写法1：匹配二级目录，简单直观
r.LoadHTMLGlob("templates/*/*")
// 写法2：兼容所有层级，跨平台通用（推荐）
r.LoadHTMLGlob("templates/**")

templates/**可适配Windows、Linux、MacOS全平台，无需区分系统，是生产环境最优选择。

场景3：三级及以上深层级目录

直接使用跨平台通用写法：r.LoadHTMLGlob("templates/**")，无需手动拼接多层通配符。

四、配套知识点：LoadHTMLGlob、c.HTML、r.Static三者的分工与关系

很多开发者混淆三者用法，连带引发路径问题，三者分工明确，互为搭档：

1. LoadHTMLGlob：加载动态HTML模板，专门解析带{{.变量}}语法的动态页面，为c.HTML渲染提供文件；纯静态HTML无需使用，直接用r.Static托管；
2. c.HTML：渲染动态页面，将后端数据注入HTML模板，必须依赖LoadHTMLGlob提前加载模板文件；
3. r.Static：托管静态资源，负责CSS、JS、图片、纯静态HTML的访问，与动态模板互不冲突。

完整Windows环境标准配置代码

package main
import "github.com/gin-gonic/gin"
func main() {
    r := gin.Default()
    // 加载HTML模板（跨平台通用写法）
    r.LoadHTMLGlob("templates/**")
    // 托管静态资源
    r.Static("/static", "./static")
    // 渲染动态页面
    r.GET("/", func(c *gin.Context) {
        c.HTML(200, "index.html", gin.H{"title":"Gin Windows模板教程"})
    })
    r.Run(":8080")
}

五、其他常见路径坑点与避坑总结

1. 相对路径失效：路径以go run main.go的执行目录为基准，不是main.go文件所在目录，运行命令需在项目根目录执行；
2. 模板文件名匹配错误：子目录模板渲染时，需填写完整相对路径，如admin/dash.html；
3. 静态HTML误用模板加载：纯静态页面直接用r.Static，无需LoadHTMLGlob，减少不必要解析。

六、结语

Gin框架的路径匹配报错，并非框架缺陷，而是跨平台通配符语法差异导致的开发环境适配问题。在Windows环境开发时，放弃Linux风格的templates/**/*写法，改用templates/**跨平台通用语法，即可彻底解决模板加载崩溃问题。同时厘清动态模板与静态资源的分工，能让Gin Web项目的页面渲染逻辑更清晰，规避后续更多路径相关bug。