Go中实现支持中间件的路由分发器需掌握http.Handler接口、闭包链式调用和路径匹配逻辑；ServeMux仅支持静态前缀匹配，无法区分方法、处理路径参数或注入中间件；正确做法是将全局与路径级中间件按前置→handler→后置组装为单层闭包链，并用"METHOD:/path"作路由键、strings.HasPrefix兼顾前缀匹配，同时中间件中必须显式调用r.WithContext传递上下文。
Go 里没有“语言学习思路”这种抽象概念可直接套用——构建支持中间件的路由分发器，靠的是对 http.Handler 接口、闭包链式调用、路径匹配逻辑这三块的扎实理解。强行套用教学术语反而容易模糊重点。
为什么不能直接复用 net/http.ServeMux
标准 http.ServeMux 只做前缀匹配，不区分 GET /users 和 POST /users，也不支持 /users/{id} 这类路径参数。注册两个同路径不同方法的 handler，后注册的会覆盖前一个；想加日志或鉴权，就得在每个 handler 里重复写 r.Context() 或 log.Printf ——这不是“学习思路”，是维护噩梦。
中间件执行顺序必须靠闭包链，不是数组遍历
全局中间件和路径级中间件混合时，顺序错误会导致鉴权被绕过或日志漏打。正确做法是把所有中间件（全局 + 路径匹配到的）按“前置→handler→后置”组装成单层闭包链：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
Use注册的中间件放最外层（最先执行、最后退出） -
UseFor("/admin")注册的中间件紧包 handler（只对该路径生效） - 不要用
for循环依次next = m(next)，那会把局部中间件插进全局链中间，破坏预期顺序 - 示例骨架：
func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request) { h := r.getHandler(req.Method, req.URL.Path) if h == nil { http.NotFound(w, req) return } // 全局中间件 → 局部中间件 → handler for i := len(r.globalMiddlewares) - 1; i >= 0; i-- { h = r.globalMiddlewares[i](h) } if ms, ok := r.routeMiddlewares[req.URL.Path]; ok { for i := len(ms) - 1; i >= 0; i-- { h = ms[i](h) } } h.ServeHTTP(w, req) }
路径匹配必须避免空指针和歧义
用 map[string]map[string]http.Handler 存路由时，外层 key 必须是 "METHOD:/path"（如 "GET:/api/users"），而不是 map[string]map[string]http.HandlerFunc —— 后者在访问未初始化的 method 子 map 时会 panic。更关键的是，路径匹配不能只靠 ==，得处理前缀场景（如 /admin 应匹配 /admin/ 和 /admin/users）：
立即学习“go语言免费学习笔记（深入）”；
- 注册
UseFor("/admin")时，实际存的是"/admin"字符串，匹配用strings.HasPrefix(req.URL.Path, key) - 但需注意：若同时注册了
"/admin"和"/admin/users"的中间件，前者会先命中，后者被忽略——这是设计选择，不是 bug - 如果需要精确路径匹配（如
/health不匹配/healthz），得额外加req.URL.Path == key || (len(req.URL.Path) > len(key) && req.URL.Path[len(key)] == '/' && req.URL.Path[:len(key)] == key)
最容易被忽略的点：中间件里的 context 传递必须显式 WithContext
很多初学者写 AuthMiddleware 时只做校验，忘了把用户信息塞进 req.Context()。后续 handler 调用 r.Context().Value("user") 拿到的是 nil，因为 http.Request 是不可变结构体，修改 context 必须用 r.WithContext(newCtx) 再传下去。漏掉这行，整个中间件链就断了。
