Echo路由匹配基于静态前缀树，时间复杂度O(1)～O(log n)，纯静态路径直接命中叶子节点，含:param或*path则走参数/通配节点，不降级正则；404是各节点独立字段，需显式设置notFoundHandler。
路由匹配走的是前缀树（Trie），不是正则或线性扫描
Echo 的路由系统底层用的是优化过的静态前缀树，所有 GET、POST 等方法的路径匹配都在 O(1)～O(log n) 时间内完成，完全避开正则解析开销。这意味着你写 /api/v1/users/:id 或 /static/js/bundle.min.js，底层都是查树节点，不编译正则、不回溯、不 panic。
常见错误是误以为 Echo 会“智能降级”到正则匹配——它不会。一旦路径含 : 或 *，就走参数/通配节点；纯静态路径直接命中叶子节点，连字符串比较都省了。
- 静态路由（如
/health、/favicon.ico）永远优先于带参数的路由，无需手动调整注册顺序 - 避免在路径中混用
:id和*path：比如/files/:id/*path会导致参数节点和通配节点共存，增加分支判断 - 大量相似前缀（如
/v1/a/...、/v1/b/...、/v1/c/...）反而有利于 Trie 层级压缩，别拆成多个独立 router 实例
路径参数命名和数量直接影响节点分裂成本
每个 :param 都会让当前节点生成一个 paramChild 指针，而 paramsCount 字段会影响内部缓存策略。实测表明，单路径超过 3 个参数（如 /a/:x/b/:y/c/:z/d/:w）会使节点内存占用上升约 40%，且首次匹配时需多跳 2～3 层指针。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 能用查询参数替代的，别塞进路径：比如
/search?q=foo&limit=20比/search/:q/:limit更轻量 - 参数名尽量短且唯一：用
:id而非:user_id，减少originalPath字段存储压力 - 嵌套路由组（
e.Group("/admin")）不增加匹配开销，但过度分组（如 5 层嵌套）会让调试时的c.Request().URL.Path和路由树实际注册路径不一致，引发日志或中间件逻辑错位
中间件里调用 c.Param() 不触发重匹配，但要注意复用上下文
c.Param("id") 是从已匹配完成的节点上直接取值，不是重新跑一遍路由。但很多人在自定义认证中间件里反复调用它，还把结果存在 c.Set() 里跨 handler 传递——这本身没问题，但若 handler 中又调用 c.Param()，就会多一次 map 查找（因为参数已解析并缓存在 c 内部）。
- 高频接口中，建议在第一个中间件里一次性提取所有必要参数，存入结构体后用
c.Set("reqCtx", ctx)，后续 handler 直接类型断言获取 - 不要在 goroutine 中长期持有
echo.Context：它来自sync.Pool，离开 handler 作用域后可能被回收，导致c.Param()返回空或 panic - 禁用
e.Debug = true上生产：它会让每次匹配额外记录node.String()，触发字符串拼接和内存分配
404 处理器不是兜底逻辑，而是 Trie 树的固定叶子节点
Echo 的 notFoundHandler 是每个 node 都有的字段，不是全局 fallback。当你访问 /missing，匹配过程走到最后一层 node 发现没有子节点、也没有注册对应 method 的 handler，才调用该 node 的 notFoundHandler。这意味着：
- 自定义 404 页面不能靠“捕获未注册路由”，必须显式设置：
e.HTTPErrorHandler = custom404 - 如果某 group 下没注册任何 handler，它的子 node 依然存在，只是
methods为空，此时访问该路径仍会走到 group 的notFoundHandler，而非顶层的 - 用
e.NoRoute()注册的处理器，本质是给 root node 设置notFoundHandler，对已注册的子树无效
json.Marshal(map[string]interface{}) 占掉 80% 时间。 
