gin通配符路由仅支持/*param语法且必须位于路径末尾，参数名需合法，捕获值含开头斜杠，注册顺序须在静态和命名参数路由之后。
通配符路由必须用 *param 语法，不能写正则或 glob
Gin 不支持 /static/**/*.js 这类 shell 风格通配，也不接受正则表达式。唯一合法的通配写法是 /static/*filepath —— 星号后面必须紧跟一个合法标识符（字母/数字/下划线），且只能出现在路径末尾。
常见错误包括：/files/*（缺参数名）、/api/v1/*id/*name（多个通配符）、/user/*id/profile（通配符不在末尾）。这些都会导致编译不报错但运行时完全不匹配。
-
r.GET("/static/*filepath", handler)✅ 正确：匹配/static/css/app.css、/static/img/logo.png -
r.GET("/files/*", handler)❌ 错误：Gin 会静默忽略该路由，请求直接 404 -
r.GET("/api/*version/users", handler)❌ 错误：通配符不能后接其他路径段
c.Param("filepath") 返回值带开头斜杠，拼文件路径要小心
通配符捕获的内容包含原始 URL 中从星号位置开始的**完整剩余路径**，且始终以 / 开头。比如请求 GET /static/js/main.js，c.Param("filepath") 返回的是 /js/main.js，不是 js/main.js。
直接拼 OS 路径容易出现 double slash，比如 os.Open("/var/www" + filepath) → /var/www//js/main.js，多数系统会容忍，但某些文件系统或容器挂载场景可能失败。
- 安全做法：
filepath := strings.TrimPrefix(c.Param("filepath"), "/")，再拼入根目录 - 或用
path.Join(root, filepath)（注意path.Join会自动处理冗余斜杠） - 别用
filepath[1:]做切片 —— 如果请求是/static/，c.Param("filepath")是/，切片会 panic
通配符路由优先级最低，必须放在最后注册
Gin 的匹配顺序是：静态路由 > 命名参数路由（:id） > 通配符路由（*filepath）。如果把通配符路由写在前面，它会吞掉所有本该由更具体路由处理的请求。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
例如：
r.GET("/static/*filepath", staticHandler)
r.GET("/static/favicon.ico", faviconHandler) // 永远不会触发
上面的 /static/favicon.ico 会被第一条通配规则先匹配，c.Param("filepath") 返回 /favicon.ico，而 faviconHandler 完全没机会执行。
- 正确顺序：先注册所有静态路径和命名参数路由，最后才挂通配符
- 检查冲突：启动时 Gin 不报错，但可通过
r.Routes()打印全部路由表人工核对顺序 - 调试技巧：临时加个
r.NoRoute()，看未命中请求是否意外落到通配符上
需要多级后缀匹配？别硬套通配符，改用 NoRoute 或中间件
通配符只解决“路径前缀固定、后面任意”的场景，比如静态文件服务。但它无法区分 .html、.json 或做条件跳转。强行用 /(*suffix) 既不合法，也违背设计意图。
真实需求如“所有 .html 请求返回模板，其余走 API”：
- ❌ 错误尝试：
r.GET("/*.html", handler)—— Gin 不识别这种写法，直接忽略 - ✅ 推荐方案：注册常规路由后，用
r.NoRoute()拦截未匹配请求，再用strings.HasSuffix(c.Request.URL.Path, ".html")判断 - ⚠️ 注意：
NoRoute是兜底，不是通配符替代品；它不参与 Radix Tree 匹配，性能略低但语义清晰
r.Group("/v1").GET("/files/*path", h) 里的 path 实际捕获的是 /v1/files/ 之后的部分——这个隐含的前缀偏移，文档很少提，但 debug 时经常卡半天。
