Group() 是 Gin 路由分组的底层机制，必须用 {} 包裹子路由以绑定作用域；函数参数须为 gin.RouterGroup 而非 gin.Engine；中间件仅作用于当前及子分组；通配符与静态路径不可混用同一分组。
Group() 不是语法糖，它是 Gin 路由组织的底层机制；漏掉花括号、传错参数类型、中间件顺序错乱，都会让路由注册到根路径或直接 panic。
为什么必须用 {} 包裹分组内部路由
Go 的语句作用域决定：不加 {} 时，r.Group("/api/v1") 返回的 *gin.RouterGroup 实例没有被变量接收，后续调用的 .GET() 会默认注册到 *gin.Engine 根路由上。
- 错误写法：
r.Group("/api/v1").GET("/users", handler)→ 实际注册路径是/users，不是/api/v1/users - 正确写法：必须显式声明作用域块，让所有子路由绑定到该分组实例
- 示例：
v1 := r.Group("/api/v1") { v1.GET("/users", getUsers) v1.POST("/login", login) }
抽离路由文件时，函数参数必须是 *gin.RouterGroup
如果在 admin/routes.go 中定义函数签名是 func InitAdminRoutes(r *gin.Engine)，那所有路由都会注册到根引擎，前缀 /admin 和中间件全部失效。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 正确签名：
func InitAdminRoutes(rg *gin.RouterGroup) - 调用方负责传入分组实例：
admin := r.Group("/admin", AuthMiddleware()); InitAdminRoutes(admin) - 错误后果：路径变成
/dashboard而非/admin/dashboard，且AuthMiddleware不生效
Group() 嵌套与中间件作用域边界
中间件只对当前分组及其子分组生效，不会穿透到兄弟分组——这是最容易被当成“自动继承”而踩坑的地方。
-
v1 := r.Group("/v1"); v1.Use(AuthMw); user := v1.Group("/user")→user继承AuthMw -
v2 := r.Group("/v2")→ 完全不受v1.Use()影响 - 全局中间件（如
Recovery()）必须在gin.Default()后立即.Use()，否则 panic 可能逃逸出捕获范围 - 嵌套过深时建议命名变量：
userV1 := v1.Group("/user")比链式v1.Group("/user").GET(...)更易 debug
通配符路径和静态路径不能混用在同一分组下
Gin 对路径匹配做严格校验，/api/:version 这类带通配符的分组里，不能再注册 /api/v1/users 这种明确静态路径，否则启动时 panic：wildcard route conflicts with existing children。
- 正确做法：通配符分组只放动态路由，静态路由走独立分组
- 例如：
g := r.Group("/files"); g.GET("/:name", serveFile)✅；但不要在同一g下再写g.GET("/download/logo.png", handler)❌ - 若需同时支持，改用
*filepath通配符并手动解析，或拆成两个分组
最常被忽略的是作用域和参数类型——Group() 返回值不接住、函数传参用错 *gin.Engine，这两点一错，整个分组就形同虚设。别依赖 IDE 自动补全，每次写完检查变量是否真正绑定了分组实例。
