Gin的Group()创建带前缀的子路由器，非字符串拼接；前缀须以/开头且不重复斜杠，如r.Group("/api/v1")；中间件必须显式调用Use()挂载，路径前缀本身无权限控制能力。
Go 语言本身没有内置路由分组能力，net/http 的 http.ServeMux 只支持简单前缀匹配，不支持嵌套、中间件隔离或路径自动拼接。真正可用的路由分组必须依赖第三方库（如 gin、gorilla/mux、chi）或手动封装——但手写容易出错且难维护。
gin.Group() 不是拼字符串，是创建子路由器
很多人误以为 r.Group("/api/v1") 后要写 .GET("/api/v1/users", h)，结果路径变成 /api/v1/api/v1/users。这是典型的手动拼接错误。
-
Group()返回的是*gin.RouterGroup，它内部持有前缀，并在注册时自动合并路径 - 正确写法：
v1 := r.Group("/api/v1"); v1.GET("/users", handler)→ 最终路由为/api/v1/users - 前缀必须以
/开头，但不能以//或多余斜杠结尾，否则可能匹配失败（比如r.Group("/api/")+.GET("/users")会注册成/api//users） - 嵌套也一样：
admin := v1.Group("/admin"); admin.GET("/logs")对应/api/v1/admin/logs
中间件必须显式挂载，Group 本身不带逻辑
Group() 只管路径前缀和路由注册隔离，不继承、不默认启用任何中间件。你以为 r.Use(Auth()) 后所有分组都受保护？其实只影响 Use() 调用之后注册的路由，分组内仍需单独 v1.Use(Auth())。
- 全局中间件应在
gin.Default()后立即调用，如r.Use(Logger(), Recovery()) - 分组中间件必须用
group.Use(m1, m2)显式绑定，多个中间件按顺序执行（洋葱模型） - 权限中间件里漏掉
c.Abort()，校验失败后 handler 仍会执行——比如删库操作照常发生 -
c.Next()控制流程继续向下，c.Abort()终止当前链，二者不可少
gorilla/mux Subrouter() 支持更细粒度控制
如果你需要路径前缀不自动归一化、想精确控制 /api 和 /api/ 的区别，或希望子路由完全独立于父路由配置，gorilla/mux 的 Subrouter() 更合适。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
-
api := r.PathPrefix("/api").Subrouter()创建子路由器，api.Use()只影响该子树 -
PathPrefix()不自动加尾部/，所以/api和/api/是两个不同前缀，需显式处理 - 子路由可继续
Subrouter()，但建议嵌套不超过 2–3 层，否则调试困难 - 变量提取用
mux.Vars(r)，不是req.URL.Query().Get()
分组路径冲突和通配符陷阱
Gin 中同一路径下重复注册会覆盖，而通配符（如 :id、*filepath）和静态路径混用极易触发 panic。
- 错误示例：
g := r.Group("/api/:version"); g.GET("/api/v1/users", h)→ 报错wildcard route conflicts with existing children - 通配符必须放在 Group 前缀之后声明：
g.GET("/users/:id", h)才合法 -
Any()是快捷方式，等价于同时注册七种方法，但不支持CONNECT或差异化处理（如 POST 需解析 body，GET 不需要） - 调试时可用
r.Routes()查看最终注册的完整路径列表，确认是否符合预期
最易被忽略的一点：分组只是语法糖，所有路由最终都注册到同一个 Engine 路由树里。路径冲突不是“组之间隔离失效”，而是根本没隔离——后注册的同路径路由直接覆盖前面的。别指望靠分组结构来规避冲突，得靠组织规范和提前检查。
