http.ServeMux不能处理复杂路由逻辑，因其仅支持前缀匹配，不支持路径参数提取、HTTP方法区分、正则约束或中间件链，需手动解析r.URL.Path并重复校验，易出错且难维护。
为什么不能直接用 http.ServeMux 处理复杂路由逻辑
http.ServeMux 只支持前缀匹配，不支持路径参数、正则、HTTP方法区分或中间件链。比如 /users/123 和 /users/profile 会同时命中 /users/，没法自动提取 123 这个 ID，也没法拒绝 PUT 请求只放行 GET。
实际项目中，一旦出现类似 /api/v2/orders/{id}/status 这种带变量和版本前缀的路径，http.ServeMux 就得靠手动字符串切割 + 条件判断，容易漏边界、难维护。
- 它不解析路径段，
r.URL.Path是原始字符串，需自行strings.Split - 无法绑定变量到
http.Request上下文，每次都要重复解析 - 没有内置方法级校验，
POST /login和GET /login得靠r.Method == "POST"手动写
手写路由分发函数的关键结构：匹配 + 提取 + 调用
核心是把请求路径和方法转成可比较的键，再查表找到对应处理器。不需要框架，几行代码就能搭出可扩展的分发器。
示例结构：
立即学习“go语言免费学习笔记（深入）”；
type Route struct {
Method string
Pattern string // 如 "/api/users/:id"
Handler http.HandlerFunc
}
var routes = []Route{
{Method: "GET", Pattern: "/api/users/:id", Handler: getUser},
{Method: "POST", Pattern: "/api/users", Handler: createUser},
}
关键点不是“怎么写正则”，而是“怎么让匹配结果能传参”。用 path.Match 只能通配，不够；推荐用 strings.Index + strings.TrimPrefix 做前缀判定，再用 strings.Split 提取变量段 —— 简单、无依赖、可控性强。
- 先比对
r.Method和Route.Method，不匹配直接跳过 - 用
strings.HasPrefix(r.URL.Path, route.Pattern)判断前缀（注意结尾斜杠） - 若 Pattern 含
:id，用strings.Split(r.URL.Path[len(route.Pattern)-3:], "/")提取后续段（假设 :id 占3字符） - 把提取的值塞进
r.Context()，再调route.Handler(w, r)
http.ServeHTTP 中如何安全注入路径参数
别改 r.URL.Path，那是只读字段。参数必须通过 context.WithValue 注入，且 key 类型要用自定义类型防冲突。
错误写法：ctx := context.WithValue(r.Context(), "id", id) —— 字符串 key 容易被其他库覆盖。
正确做法：
type contextKey string const userIDKey contextKey = "user_id" // ... ctx := context.WithValue(r.Context(), userIDKey, id) r = r.WithContext(ctx)
处理器里取值时，也必须用同一 userIDKey，否则取不到。
- 不要用
interface{}当 key，哪怕只在自己代码里用，也建议定义命名类型 - 提取失败（如
/api/users/后没 ID）应返回http.Error(w, "bad path", http.StatusBadRequest)，而不是 panic - 如果多个参数（如
:id和:token），按顺序拆分路径段，别依赖正则捕获组，避免回溯爆炸
什么时候该放弃手写、改用 gorilla/mux 或 chi
手写适合学习、小工具或嵌入式服务；但一旦要加 CORS、超时、日志中间件、子路由器（如 /api/v1/ 下挂一堆 handler），就很快变成状态管理泥潭。
gorilla/mux 的 Router.HandleFunc 支持 {id:[0-9]+} 正则约束，chi 的 Mount 能复用中间件，这些都不是几行 if-else 能轻松补上的。
- 如果你需要
OPTIONS预检自动响应，chi的middleware.DefaultCompress开箱即用 - 如果团队已有
chi经验，新项目直接用它，省去手写路由的测试覆盖成本 - 但如果只是给内部 CLI 工具起个 HTTP 管理端口，5 个固定路径，手写更轻、无依赖、debug 直观
真正容易被忽略的是：路径匹配的优先级。手写时你控制顺序，而 gorilla/mux 按注册顺序匹配，chi 按最长前缀匹配 —— 同一个 /users 和 /users/{id}，注册顺序反了就会永远走不到后者。
