Group()是Gin路由分组必需手段，非可选技巧；其通过calculateAbsolutePath()拼接basePath与relativePath实现路径自动组合，对斜杠敏感，须避免前缀尾部/和子路径缺失/；中间件为叠加式合并，按注册顺序执行。
路由分组不是“可选技巧”，而是 Gin 项目规模超过 5 个接口后必须落地的组织手段；不提前设计，后期拆分成本远高于初期规划。
为什么 Group() 调用后路径会自动拼接？
因为 Group() 内部调用 calculateAbsolutePath()，把传入的 relativePath 和父组的 basePath 字符串拼接（不是正则或路径解析），所以它对斜杠非常敏感：
-
r.Group("/api")+GET("/users")→ 实际匹配/api/users（正确） -
r.Group("/api/")+GET("/users")→ 匹配/api//users（多一个斜杠，404） -
r.Group("/api")+GET("users")（无前导斜杠）→ 仍为/api/users，Gin 会自动补前导斜杠
结论：组路径末尾不要加 /，子路由路径开头加不加 / 都行，但统一写法更安全 —— 建议子路由都带前导 /。
Group() 的中间件参数是“叠加”还是“覆盖”？
是叠加，不是覆盖。每个 Group() 可传入多个中间件函数，它们会和父组已有的中间件**按顺序合并到 HandlersChain 中**：
-
r.Use(m1)→ 全局中间件 -
v1 := r.Group("/v1", m2)→v1组的链为[m1, m2] -
admin := v1.Group("/admin", m3)→admin组链为[m1, m2, m3]
注意：中间件执行顺序严格按注册顺序，m1 最先执行、m3 最后；若某个中间件 return 或调用 c.Abort()，后续中间件和 handler 都不会执行。
如何避免 main.go 膨胀成路由垃圾场？
核心是把每个业务模块抽成独立函数，并接收 *gin.RouterGroup 作为参数：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 新建
routes/user.go，定义func UserRoutes(rg *gin.RouterGroup) - 在
main.go中只留调度逻辑：userGroup := r.Group("/users"); UserRoutes(userGroup) - 如果某组需要专属中间件（如鉴权），就在调用前
userGroup.Use(AuthMiddleware())，不要塞进函数内部 - 禁止在抽离函数里调用
r.Group(...)—— 那会脱离当前组上下文，导致路径错乱
抽离后，main.go 路由部分应不超过 15 行，所有路径前缀、中间件绑定、分组嵌套都在顶层控制，子模块只负责注册具体 handler。
嵌套分组时，路径拼接容易漏掉哪一层？
最常漏的是“资源子组”的路径层级。比如用户管理想拆成 /api/v1/users/{id}/posts，错误写法：
v1 := r.Group("/api/v1")
users := v1.Group("/users") // ✅ 正确：/api/v1/users
users.GET("/:id", getUser) // → /api/v1/users/:id
// 错误：posts 组没挂到 users 下，而是挂到了 v1 下
posts := v1.Group("/posts") // ❌ 结果是 /api/v1/posts，不是 /api/v1/users/:id/posts
正确做法是：
users := v1.Group("/users")
{
users.GET("/:id", getUser)
posts := users.Group("/:id/posts") // ✅ 挂在 users 下，路径自动为 /api/v1/users/:id/posts
{
posts.GET("", listUserPosts)
posts.POST("", createUserPost)
}
}
嵌套层级越深，越要确认 Group() 的 receiver 是上一级组变量，而不是根 r —— 这个细节一旦出错，调试时根本看不出路径拼错了哪一截。
