Gin 的 Group 是路由树的显式分层控制点，返回 gin.RouterGroup 作为轻量代理，负责前缀拼接与中间件继承；路径需显式带斜杠，中间件按注册顺序线性追加，模块化路由应接收 gin.RouterGroup 参数以解耦。
Gin 的 Group 不是语法糖，而是路由树结构的显式分层控制点——用错位置或忽略继承规则，会导致中间件不生效、路径拼接错误、甚至路由被覆盖。
为什么 Group 返回的是 *gin.RouterGroup 而不是 *gin.Engine
这是 Gin 路由设计的关键前提：Group 方法返回的 *gin.RouterGroup 是一个轻量级代理对象，它内部持有父级 *gin.Engine 或上层 *gin.RouterGroup 的引用，并记录当前前缀路径和已注册的中间件列表。它本身不处理请求，所有 .GET/.POST 等方法最终都委托给底层引擎的 radix tree 进行注册。
这意味着：
-
router.Group("/api")和router.Group("/api/v1").Group("/users")生成的路径分别是/api/*和/api/v1/users/*，两级Group会叠加前缀 - 不能对
*gin.RouterGroup调用.Run()或.SetFuncMap()—— 这些方法只在*gin.Engine上存在 - 中间件调用顺序严格按
Use()的先后顺序执行，且仅作用于该组及其子组，不会穿透到兄弟组
Group 嵌套时路径拼接的常见陷阱
路径拼接看似简单，但实际容易因斜杠缺失/冗余导致 404。Gin 不自动补斜杠，也不去重，完全按字面拼接。
立即学习“go语言免费学习笔记（深入）”；
例如：
v1 := r.Group("/v1")
users := v1.Group("users") // 注意：这里没写 "/" → 实际路径是 /v1users/xxx（错误！）
正确写法必须显式带上前导斜杠：
v1 := r.Group("/v1")
users := v1.Group("/users") // ✅ 拼接后为 /v1/users/xxx
其他易错点包括：
- 父组前缀以
/结尾，子组又以/开头 → 产生双斜杠//，多数 HTTP 客户端会自动归一化，但某些网关或测试工具可能报错 - 使用变量构造前缀（如
r.Group(fmt.Sprintf("/api/%s", version))）时未校验变量是否含多余斜杠 - 在
Group内部再调用Group时，误以为可省略斜杠（比如admin.Group("dashboard")应为admin.Group("/dashboard")）
分文件管理路由时，Group 的参数传递方式决定模块解耦程度
把路由拆到不同文件，核心是让每个模块只关心“自己该注册哪些路由”，而不是“我该往哪个 engine 上挂”。最稳妥的方式是让路由初始化函数接收 *gin.RouterGroup，而非 *gin.Engine。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
比如用户模块应这样定义：
func SetupUserRoutes(rg *gin.RouterGroup) {
rg.GET("", listUsers)
rg.POST("", createUser)
rg.GET("/:id", getUser)
}
主程序中调用：
userAPI := r.Group("/api/v1/users")
SetupUserRoutes(userAPI)
这种写法的好处：
- 模块不依赖全局
engine，可单独单元测试 - 前缀由调用方控制，同一组路由可在不同环境挂载到不同路径（如测试环境挂
/test/api/v1/users） - 避免在模块内硬编码
r.Group("/api/v1/users")，否则无法复用
反模式是让模块自己调用 gin.Default() 或接收 *gin.Engine —— 这会让模块强耦合启动逻辑，且中间件无法按组隔离。
中间件在 Group 中的继承与覆盖行为
Gin 的中间件是“继承式追加”，不是“覆盖式替换”。子组会继承父组所有中间件，并在其基础上追加自己的。
例如：
api := r.Group("/api")
api.Use(AuthMiddleware(), LoggingMiddleware())
v1 := api.Group("/v1")
v1.Use(VersionCheckMiddleware()) // 此时 v1 下路由实际执行顺序：Auth → Logging → VersionCheck
admin := v1.Group("/admin")
admin.Use(AdminOnlyMiddleware()) // admin 下路由顺序：Auth → Logging → VersionCheck → AdminOnly
注意：
- 中间件执行顺序 = 父组注册顺序 + 子组注册顺序，不可逆序
- 没有“跳过父组中间件”的机制；若某子路由需绕过认证，只能单独提出来注册在未加中间件的组里，或在中间件内做路径判断跳过
-
Use()必须在Group()后、路由注册前调用；放在{}块内或块外效果相同，但放错位置（如注册完路由再Use）无效
真正难调试的，往往不是不会用 Group，而是没意识到它背后是树状结构 + 前缀字符串拼接 + 中间件线性追加三者共同作用的结果。路径写错、中间件漏加、模块间前缀冲突，八成出在这里。
