Go 的 http.ServeMux 使用最长前缀匹配：遍历注册的 pattern，选取以请求路径开头且长度最长者；不支持通配符或参数提取，仅做前缀分发，需手动裁剪路径获取参数。
Go 的 http.ServeMux 是怎么匹配路由的
Go 标准库的 net/http 没有“路由树”或“正则匹配”，它用的是**最长前缀匹配 + 字符串相等判断**。也就是说：http.ServeMux 内部维护一个按路径字典序排序的 map[string]muxEntry，但实际查找时不是简单查表，而是遍历所有已注册的 pattern，找**最长的、以请求路径开头的 prefix**（注意：是“以它开头”，不是“完全相等”）。
比如你注册了 /api/ 和 /api/users，请求 /api/users/123 会命中 /api/users，因为它是更长的匹配前缀；而请求 /api/foo 会命中 /api/（因为 /api/ 是前缀，且比 /api/users 更短但唯一匹配）。
关键点：
-
http.HandleFunc("/v1", ...)实际注册的是/v1—— 它会匹配/v1、/v1/、/v1/foo，但不会匹配/v10 -
http.HandleFunc("/v1/", ...)注册的是/v1/（末尾带斜杠），它会匹配/v1/、/v1/foo、/v1/bar/baz，但不匹配/v1 - 如果两个 pattern 都注册了（比如
/v1和/v1/），/v1/优先级更高（因为更长），但/v1仍可能被/v1请求（无尾斜杠）命中
为什么 http.ServeMux 不支持通配符和参数提取
标准 http.ServeMux 的设计哲学是极简——它只做“前缀分发”，不解析路径段、不捕获变量、不支持 /user/:id 或 /file/{name}.jpg 这类语法。这是有意为之，不是缺陷。
立即学习“go语言免费学习笔记（深入）”；
这意味着：
- 你不能靠
http.ServeMux直接拿到:id的值，必须自己strings.Split(r.URL.Path, "/")手动切分 - 注册
/user/123和/user/456是无效的（ServeMux 不允许注册非前缀 pattern） - 想实现 RESTful 路由，必须用第三方库（如
gorilla/mux、chi）或自己封装中间件
常见误操作：
http.HandleFunc("/user/:id", handler) // ❌ 不生效，:id 被当字面量处理，只匹配字面路径 "/user/:id"
如何在不引入第三方库的前提下做简单路径参数提取
如果你只是需要轻量级参数提取（比如 /api/v1/user/123 → 提取 123），可以用 http.ServeMux + 手动路径裁剪，关键是利用好“前缀匹配后剩余部分”：
func userHandler(w http.ResponseWriter, r *http.Request) {
// 注册的是 "/api/v1/user/"，所以 r.URL.Path 一定是 /api/v1/user/xxx 形式
path := strings.TrimPrefix(r.URL.Path, "/api/v1/user/")
if path == "" || strings.HasPrefix(path, "/") {
http.Error(w, "not found", http.StatusNotFound)
return
}
id := path // 现在 id 就是 "123" 或 "123/profile"
// 继续处理...
}
注册方式：
http.HandleFunc("/api/v1/user/", userHandler)
注意事项：
- 确保注册 pattern 以
/结尾，否则无法稳定截取后缀 - 要校验
path是否为空或含非法字符（如..），避免路径穿越 - 这种写法不支持嵌套路由（如
/user/123/post/456），需额外分层处理
自定义 http.Handler 替代 http.ServeMux 的典型场景
当你需要精确控制匹配逻辑（比如忽略大小写、支持 glob、跳过静态文件路径），直接实现 http.Handler 比 patch http.ServeMux 更干净：
type CaseInsensitiveMux struct {
mux map[string]http.HandlerFunc
}
func (m *CaseInsensitiveMux) ServeHTTP(w http.ResponseWriter, r *http.Request) {
handler, ok := m.mux[strings.ToLower(r.URL.Path)]
if !ok {
http.NotFound(w, r)
return
}
handler(w, r)
}
使用：
mux := &CaseInsensitiveMux{mux: make(map[string]http.HandlerFunc)}
mux.mux["/api/users"] = usersHandler
http.ListenAndServe(":8080", mux)
这种方式绕过了 http.ServeMux 的前缀逻辑，完全自主控制。但代价是你得自己管理注册、冲突检测、404 分发等——标准库的“不够用”恰恰是它保持稳定的原因。
真正容易被忽略的是：ServeMux 的匹配发生在 Server.Serve 循环内，任何中间 handler（如日志、CORS）都必须在它之前或之后链式调用，顺序错了就收不到路由分发结果。
