Echo路由匹配优先级为静态＞参数＞通配符，按节点kind硬编码排序，非注册顺序；静态路由必须最先注册，参数路由次之，通配符最后，且路径需归一化一致才能正确提取参数。
路由匹配优先级：静态 > 参数 > 通配符
Echo 不是按注册顺序匹配，而是按节点 kind 类型硬编码优先级：静态路径（skind）最高，参数路径（pkind）次之，通配符（akind）最低。这意味着即使你后注册 /users/:id，先注册 /users/new，请求 GET /users/new 也一定命中静态路由，不会被参数路由捕获。
常见错误现象：
- 注册了
/users/:id后，再注册/users/new，结果/users/new返回 404 - 把
/files/*放在前面，导致所有/files/xxx都被通配符吞掉，连/files/upload这类明确端点也无法访问
正确做法：
- 静态路由必须最先注册（如
/health、/metrics、/users/new） - 参数路由其次（如
/users/:id、/posts/:slug） - 通配符最后（如
/api/v1/*、/static/*）
基数树（Radix Tree）如何组织路由节点
每个路由节点的 prefix 是共享前缀，不是完整路径；label 是该节点分支的第一个字节；paramChild 和 anyChild 是独立指针，不混在 children 数组里。这使得 /users/:id 和 /users/123 在树中分属不同子树，互不干扰。
举个实际例子：
/users ├── new // static, skind ├── :id // param, pkind → 指向 paramChild └── 1/files/* // any, akind → 实际走的是 /users/1/files/* 的 akind 分支，不是 /users 下挂载
注意：/users/1/files/* 并不会作为 /users 的子节点插入，而是被拆解为 /users → /1 → /files/*，其中最后一段触发 anyChild 跳转。这也是为什么通配符必须写全路径前缀，不能只写 /*。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
c.Param() 提取不到值？检查节点类型和路径归一化
c.Param("name") 返回空字符串，往往不是代码写错，而是路由没被识别成 pkind 节点。Echo 在注册时会对路径做 normalizePathSlash：连续多个 / 会被压缩，末尾 / 会被移除。所以 /users//id 或 /users/:id/ 实际注册的是 /users/:id，但若 handler 绑定在 /users/:id/（带尾斜杠），则请求 /users/123 就无法匹配。
关键点：
- 路径注册时自动归一化，但 handler 绑定的路径字符串必须与归一化结果一致
-
:id必须出现在非末尾位置或末尾无斜杠，否则可能降级为 static 节点 - 调试时可用
e.Debug = true启动，Echo 会在启动日志中打印完整路由树结构
为什么 Group 不影响路由匹配性能？
e.Group("/api") 看似新增一层嵌套，其实只是对路径前缀做字符串拼接，并把中间件链挂载到子 Group 上。所有路由最终都插入到根 e.Router 的同一棵基数树中，Group 本身不参与运行时匹配——它不生成新节点，也不改变树结构。
这意味着：
-
api := e.Group("/api"); api.GET("/v1/users", h)等价于直接注册e.GET("/api/v1/users", h) - Group 唯一作用是聚合中间件和 prefix，没有额外匹配开销
- 嵌套 Group（如
e.Group("/a").Group("/b")）会合并 prefix 成/a/b，仍是一次性插入树中
真正容易被忽略的是：Group 中间件执行顺序依赖注册时机，而不是 Group 嵌套深度。比如在 Group 内部先注册路由、再调用 Use()，该中间件对已注册路由不生效——这个行为和路由匹配无关，但常被误认为“Group 影响了路由”。
