Gin 的路由使用 Radix Tree（压缩前缀树）而非 map，按路径段严格匹配：/user/:id 拆为 ["user", ":id"] 两段，故不匹配 /user（仅一段）或 /user/（末尾空段）；:id 是特殊通配节点，只接受非空路径段，不模糊补全。
Gin 的路由不是靠 map 查路径，而是用 Radix Tree（压缩前缀树）做匹配；注册 r.GET("/user/:id", handler) 时，实际是在对应 HTTP 方法的树上插入节点，不是存字符串键值对。
为什么 r.GET("/user/:id") 不会匹配 /user 或 /user/
因为 Radix Tree 节点匹配是严格按路径段（path segment）划分的：/user/:id 被拆成 ["user", ":id"] 两段，而 /user 只有一段、/user/ 末尾多出空段，都不满足结构。树中 :id 是一个带通配标记的子节点，只接受非空、非分隔符的连续字符（如 /user/123），但不会回退或模糊补全。
- 若想让
/user也生效，得显式注册r.GET("/user", handler) -
RedirectTrailingSlash = true（默认开启）仅对静态路径起作用，对含参数的路径无效 - 树节点的
priority字段控制同级节点匹配顺序，但不改变段数约束
engine.trees["GET"] 是怎么被构建和查找的
每个 HTTP 方法（"GET"、"POST" 等）在 engine.trees 中独占一棵 Radix Tree。调用 r.GET("/a/b", h) 时，最终执行的是 root.addRoute("/a/b", handlers) —— 这个 root 就是 engine.trees["GET"] 指向的 *node。
- 插入时，路径按
/切分，逐段向下找或新建节点，公共前缀自动合并（比如/api/users和/api/posts共享/api节点） - 查找时，
engine.ServeHTTP()先取req.Method得到树根，再遍历路径段，每步用node.child链表线性比对（因节点数少，未用哈希或跳表） - 遇到
:param或*wildcard节点时，进入特殊匹配逻辑：前者要求段非空且不包含/，后者捕获剩余全部路径
路由组（Group）只是路径拼接 + 中间件叠加，不生成新树
user := r.Group("/user") 并不会创建独立的 Radix Tree，它只是把 /user 记为前缀，后续所有 user.GET("/profile", h) 实际注册的是 /user/profile 到 engine.trees["GET"] 上。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
RouterGroup的basePath字段用于拼接，Handlers字段用于合并中间件链，二者都不影响树结构 - 嵌套组（如
r.Group("/v1").Group("/users")）只是字符串累加，最终路径仍是扁平的/v1/users/xxx - 所以
Group的性能开销几乎为零，它纯属逻辑组织，不增加路由匹配成本
常见误配导致 404 的真实原因
很多 404 不是 handler 没写对，而是路径结构或树行为没理解清楚：
-
r.POST("/upload", h)和r.GET("/upload", h)存在不同树上，发 GET 请求到/upload必然 404，跟 handler 是否存在无关 -
r.GET("/v1/user/:id", h)无法匹配/v1/user/123/extra——:id后不能再有段，除非用*filepath（如/v1/user/:id/*filepath） - 如果启用了
HandleMethodNotAllowed = true，但没设置allNoMethod处理器，遇到方法不支持时会直接返回 405，而不是 fallback 到 404 - 路由注册顺序不影响匹配结果（Radix Tree 不依赖顺序），但会影响
priority值，进而影响同级节点遍历顺序——这点在含冲突模式（如/user/:id和/user/new）时才显现
真正容易被忽略的是：Radix Tree 匹配发生在请求进入 Context 之前，一旦匹配失败，中间件甚至不会执行；所以日志里看不到中间件打印，不代表中间件没生效，可能根本没走到那一步。
