Gorilla Mux 路由指南
Gorilla Mux 路由指南：路径变量、方法匹配、正则约束、子路由和中间件。对照 Go 1.22 起 ServeMux 已支持的路径变量与方法模式，说明选型差异。
本文依据官方文档整理，未执行运行验证或性能基准。代码片段展示局部用法，业务函数、数据和环境需按项目补齐；版本与配置以所引文档为准。
直接回答：Gorilla Mux 是 Go 生态经典的增强路由器——标准库 ServeMux 支持路径及子树匹配，Go 1.22 起还支持方法和路径变量；Mux 提供路径变量（/users/{id}）、方法过滤、主机/头匹配、子路由与中间件。Go 1.22 后标准库已支持基本路径参数，但复杂路由需求 Mux 仍是稳妥之选。
标准库路由的局限
http.HandleFunc("/", homeHandler)
http.HandleFunc("/about", aboutHandler)
Go 1.22+ 可用 http.HandleFunc("GET /users/{id}", getUser) 与 r.PathValue("id")。标准 http.Handler 也可组合中间件；只有确需正则、Host/Headers 匹配或 Mux 子路由约定时再引入依赖。
Mux 基础
r := mux.NewRouter()
r.HandleFunc("/users/{id:[0-9]+}", getUser).Methods("GET") // 正则约束
r.HandleFunc("/articles/{category}/{id:[0-9]+}", getArticle)
handler 中的 mux.Vars(request) 从 *http.Request 取路径变量（不是传入 *mux.Router）；Queries() 匹配查询参数；Headers()/Host() 做内容协商与多租户路由。
子路由与中间件
api := r.PathPrefix("/api/v1").Subrouter()
api.Use(authMiddleware, loggingMiddleware)
api.HandleFunc("/users", listUsers).Methods("GET")
子路由继承前缀与中间件——版本化 API（/api/v1、/api/v2）与分层鉴权的标准结构。
中间件写法
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
next.ServeHTTP(w, r)
log.Printf("%s %s %v", r.Method, r.URL.Path, time.Since(start))
})
}
标准 http.Handler 签名——Mux 中间件与标准库生态完全兼容。
错误处理
NotFoundHandler 与 MethodNotAllowedHandler 自定义 404/405 响应（返回 JSON 而非默认文本），API 服务的错误格式统一从这里收口。
常见问题（FAQ）
Q：Go 1.22 标准路由够用了还要 Mux 吗？
A：1.22 的 ServeMux 支持 /users/{id} 与方法匹配，简单应用够了。需要正则约束、子路由继承、丰富匹配器时 Mux 仍更强。
Q：Mux 和 Gin/Echo 框架怎么选？
A：Mux 是"路由器"，框架是"全家桶"（绑定、渲染、验证都有）。想用标准库风格自由组合选 Mux；想要一站式约定选 Gin。
Q：路由冲突怎么排查？
A：Mux 按注册顺序匹配——更精确的规则先注册。r.Walk() 可打印全部路由表，冲突一目了然。
官方参考
资料核对日期：2026-09-29。
