嵌套子路由必须用上一级 Group 实例调用 Group()，如 v1.Group("/admin")，而非 r.Group("/admin")；前缀须以 / 开头且无尾部斜杠；中间件不自动继承，需显式调用 Use()；嵌套不宜超过 3 层。
嵌套子路由必须用上一级 Group 实例调用 Group()
嵌套不是靠路径拼接，而是靠 RouterGroup 链式构建。你不能直接用 r.Group("/v1/admin") 创建嵌套结构——这只是一个扁平分组；真要嵌套，必须用前一级分组对象去调用 Group()，比如 v1.Group("/admin")。否则中间层的前缀逻辑就断了，路由树无法形成层级关系。
常见错误现象：v1 := r.Group("/api/v1"); admin := r.Group("/admin") → /admin 路由实际注册在根级，和 /api/v1 完全无关，根本不是嵌套。
-
v1 := r.Group("/api/v1")是第一级分组 -
admin := v1.Group("/admin")才是合法嵌套，admin继承v1的前缀 -
admin.GET("/logs")最终匹配路径是/api/v1/admin/logs，不是/admin/logs
Group() 的前缀参数必须以 / 开头，且不能有尾部多余斜杠
前缀写成 "admin" 或 "admin/" 都会导致实际路径异常：前者变成 /api/v1admin（自动连写无分隔），后者可能触发重复斜杠匹配失败或 404。Gin 内部不做路径标准化，它原样拼接字符串。
使用场景：当你想把 /v2 和 /v2/users、/v2/posts 归为一组，再把 /v2/admin 下的接口单独管理时，必须确保每级 Group() 的参数都是干净的 "/v2"、"/admin" 这类形式。
- ✅ 正确：
v2 := r.Group("/v2"); admin := v2.Group("/admin") - ❌ 错误：
v2 := r.Group("v2")、admin := v2.Group("/admin/")、admin := r.Group("/v2/admin") - 错误写法会导致路由不可达，但编译不报错，调试时容易卡在“为什么这个路径 404”
嵌套分组不自动继承中间件，Use() 必须显式调用
很多人误以为子分组会自动带上父分组的中间件，其实不会。v1.Use(AuthMiddleware()) 只影响 v1 直接注册的路由；admin := v1.Group("/admin") 是个全新 RouterGroup 实例，中间件列表为空，必须自己调用 admin.Use(...)。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
性能影响：中间件执行顺序严格按注册顺序，比如全局日志 + v1 鉴权 + admin 权限校验，最终链路就是日志 → 鉴权 → 权限校验 → handler。如果漏掉某一级的 Use()，对应逻辑就完全跳过，权限控制形同虚设。
- 父分组加了 JWT 中间件，子分组没加 → 子路由不校验 token
- 子分组加了 CORS，父分组没加 → 父路由仍可能被浏览器跨域拦截
- 所有中间件都得手动挂载，没有隐式继承，这是 Gin 的明确设计选择
嵌套太深会让路由调试变困难
超过 3 层嵌套（比如 r.Group("/api").Group("/v2").Group("/admin").Group("/system")）后，路径推导和测试成本明显上升。出问题时你得一层层确认每个 Group() 是谁调用的、前缀是否一致、中间件有没有漏挂。
容易被忽略的地方：路由树是静态构建的，一旦 r.Run() 启动，所有分组结构就固定了；没法运行时动态增删某一层分组。所以嵌套层级应在设计期收敛，别为了“看起来模块化”而强行多套一层。
建议把版本号（/v1）、模块名（/user）、子功能（/profile）拆成 2～3 层足够，更细的粒度用函数封装路由注册逻辑，而不是靠 Group() 堆叠。
