Gin路由核心是engine.trees中按HTTP方法分立的前缀树，路径段逐层分裂，匹配复杂度O(k)；动态参数需显式声明，Group仅为路径前缀与中间件叠加语法糖，所有路由终归同一棵树。
gin.Engine.trees 是路由匹配的核心数据结构
Gin 的路由分发不靠反射或字符串遍历，而是基于 engine.trees 中维护的多棵前缀树（radix tree）。每种 HTTP 方法（GET/POST/PUT 等）独占一棵树，节点按路径段（如 /api、/users）逐层分裂。这种结构让路由查找时间复杂度稳定在 O(k)，k 是路径段数量，远优于 map 查找的哈希碰撞风险或正则全量扫描。
你注册 r.GET("/v1/users/:id", handler) 时，Gin 并不会生成正则表达式去匹配每个请求；而是把 v1、users、:id 拆成三段，插入到 GET 树中对应分支。当请求 GET /v1/users/123 到来，引擎沿树向下匹配，遇到 :id 节点就提取 123 并写入 c.Param("id")。
常见错误是误以为 Gin 支持通配符路径如 /api/** ——它不支持。所有动态段必须显式声明为 :param 或 *wildcard，且 wildcard 只能出现在路径末尾。
路由分组（RouterGroup）本质是路径前缀 + 中间件链叠加
router.Group("/api/v1") 不会创建新路由树，只是返回一个带 basePath = "/api/v1" 和当前中间件栈副本的 RouterGroup 实例。后续调用 g.GET("/users", h) 时，实际注册的是 GET /api/v1/users 到主树中。
这意味着：不同 Group 的中间件互不影响，但最终所有路由都落在同一棵 GET/POST 树里；Group 嵌套只是语法糖，不是隔离域。如果你在 g1 := r.Group("/v1") 和 g2 := r.Group("/v2") 下注册相同子路径（如 /users），它们会成为树中两个完全独立的叶子节点，彼此无覆盖关系。
性能影响：Group 本身无开销，但中间件叠加会增加每次请求的函数调用深度。避免在顶层 Group 里塞大量中间件，再在子 Group 里重复 Use —— 应按职责收敛，比如鉴权放最外层，日志按业务域分组启用。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
参数提取与冲突判定发生在匹配完成之后
路径匹配成功只代表“找到候选 handler”，真正执行前还要做两件事：校验动态参数是否冲突、提取值并注入 Context。例如你注册了 /users/:id 和 /users/profile，当请求 /users/profile 到来，Gin 会优先匹配字面量节点 profile，而非把 profile 当作 :id 值——因为字面量优先级高于参数占位符。
但如果注册顺序反过来，先 /users/profile 再 /users/:id，结果一样；Gin 在构建树时已按规则排序，无需依赖注册顺序。但若出现 /users/:id/photo 和 /users/:name 这类无法静态区分的模式，Gin 会在启动时 panic 报错 "node with the same path '/' already exists"，强制你在设计阶段暴露歧义。
注意：c.Param("id") 返回的是字符串，不会自动类型转换；需手动调用 strconv.Atoi 等处理。别指望框架替你做参数合法性校验，那是业务逻辑该干的事。
中间件链与 handler 执行是线性压栈，不参与路由决策
路由分发只决定“哪个 handler 函数被调用”，不决定“中间件怎么跑”。所有中间件（包括 Use() 注册的和 Group 绑定的）会在 handler 前按注册顺序依次执行，形成一条固定链。哪怕你用 gin.HeaderSelector 在中间件里读取 X-API-Version，也只是往 c 里塞个值，不会触发路由重选或跳转。
所以，想实现 header 驱动的版本分发，不能靠中间件 abort 后换路由，而必须：在中间件里提取并校验版本，存进 c.Set("api_version", "v2")；然后在 handler 里用 c.GetString("api_version") 分支调用不同逻辑。否则你就把路由逻辑和业务逻辑搅在一起，既难测又难维护。
容易被忽略的一点：c.Next() 控制中间件执行流，但它不改变请求路径或方法。一旦路由已选定 handler，中间件再怎么 c.Request.URL.Path = "/other" 也无效——下一轮匹配不会发生。
