httprouter 路径匹配更快因其采用基数树（radix tree），时间复杂度接近 O(k)，而 net/http.ServeMux 为顺序匹配，最坏 O(n)；但大量通配符会削弱优势。
httprouter 路由匹配为什么比 net/http 默认路由快？
因为 httprouter 用的是基数树（radix tree），不是遍历切片或 map 查找。每次 URL 匹配只走一次树路径，时间复杂度接近 O(k)，k 是 URL 路径长度；而 net/http 的 ServeMux 是顺序匹配注册的 pattern，最坏 O(n) —— 注册 100 个路由，可能要扫完 99 个才命中最后一个。
但注意：快的前提是路径结构规整。如果大量使用通配符 :id 或 *catchall，树分支变多，性能优势会收窄；极端情况（比如所有路由都带 *catchall）甚至退化成线性查找。
- 适合场景：RESTful API、固定层级路径（如
/api/v1/users、/api/v1/posts/:id） - 不适合场景：需要正则动态提取、路径含大量不规则 query 参数参与路由判断
- 兼容性无问题：纯 Go 实现，Go 1.16+ 都可直接
go get github.com/julienschmidt/httprouter
怎么注册带参数的路由并安全取值？
httprouter 不自动解析 URL 参数到 struct，得手动从 http.Request 的 PathParam 方法拿。容易错在：以为 req.URL.Query().Get("id") 能取到 :id，其实不能 —— 那只是 query string，和路由参数无关。
正确做法是用 ps.ByName("id")，其中 ps 是 httprouter.Params 类型，由框架传入 handler：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
func getUser(w http.ResponseWriter, r *http.Request, ps httprouter.Params) {
id := ps.ByName("id") // ✅ 正确：从路径中取 :id
// id := r.URL.Query().Get("id") // ❌ 错：这是 ?id=xxx，不是 /users/:id 中的 :id
fmt.Fprintf(w, "user id: %s", id)
}
- 参数名必须和路由定义一致：
router.GET("/users/:id", getUser)→ 只能用ps.ByName("id") - 没有类型转换：返回
string，需自己转strconv.Atoi等，别漏错误处理 - 不存在的参数名返回空字符串，不会 panic，但容易静默出错 —— 建议加
if id == ""校验
为什么 404 总是返回空响应而不是自定义页面？
httprouter 默认的 NotFound 处理器只写 HTTP 状态码，不输出任何 body。你看到的“空白页”，其实是浏览器收到 404 但没内容渲染出来的假象。
要改这个行为，必须显式设置 router.NotFound：
router.NotFound = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotFound)
w.Write([]byte("404: page not found"))
})
- 别漏
w.WriteHeader(http.StatusNotFound)，否则状态码还是 200 - 如果用了模板或 JSON 响应，这里也要统一格式，否则和正常接口不一致
- 静态文件服务（如
http.FileServer）和httprouter不自动打通，404 不会 fallback 到文件系统 —— 得自己在NotFound里判断路径是否对应磁盘文件
能不能混用 httprouter 和标准库中间件？
可以，但要注意函数签名差异。标准库中间件接收 http.Handler，而 httprouter 的核心类型是 httprouter.Handle（三个参数）。直接套用会编译报错：cannot use router (type *httprouter.Router) as type http.Handler。
解决方法是用 router.ServeHTTP 包一层：
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
log.Println(r.Method, r.URL.Path)
next.ServeHTTP(w, r)
})
}
// 正确包装方式：
handler := loggingMiddleware(http.Handler(router))
http.ListenAndServe(":8080", handler)
- 别写
loggingMiddleware(router)—— 类型不匹配 - 所有依赖
http.Handler接口的中间件（如gorilla/handlers）都得这样包 - 性能影响极小：只是加了一层函数调用，没额外内存分配
NotFound 导致前端收不到错误体。这两处一错，调试半天都看不出哪有问题。 
