gorillamux：Go语言路由库的实用选择

gorilla/mux：Go语言路由库的实用选择

Go 标准库的 http.ServeMux 只做最简单的路径前缀匹配，路径变量、按 HTTP 方法分发这些需求它都不支持。gorilla/mux 填补了这个空缺，21,848 个 Star 让它成为 Go 生态中使用最广泛的路由库之一。

匹配维度全面

mux 实现了 http.Handler 接口，可以直接替换标准库的 ServeMux，现有项目改造成本很低。路由规则覆盖了实际开发中常见的匹配维度：

路径变量：{name} 获取任意值，{name:pattern} 用正则约束格式
域名和子域名：Host("www.example.com") 或 Host("{subdomain:[a-z]+}.example.com")
HTTP 方法：Methods("GET", "POST")
请求头和查询参数：Headers() 和 Queries() 匹配器
自定义逻辑：MatcherFunc 接收一个函数，匹配条件完全由你定义

多个匹配器可以链式组合。一条路由同时约束域名、方法、路径前缀：

go 复制代码

r.HandleFunc("/products", ProductsHandler).
  Host("www.example.com").
  Methods("GET").
  Schemes("http")

匹配顺序按路由注册先后，先匹配到的先生效。这意味着具体路由要写在通配路由前面，逻辑直观，没有隐藏规则。

子路由机制

一组路由共享相同前置条件时，子路由（Subrouter）避免了在每个路由上重复声明匹配器：

go 复制代码

s := r.Host("www.example.com").Subrouter()
s.HandleFunc("/products/", ProductsHandler)
s.HandleFunc("/products/{key}", ProductHandler)
s.HandleFunc("/articles/{category}/{id:[0-9]+}", ArticleHandler)

子路由下注册的路径自动继承父级的域名约束。请求到达时，如果域名不匹配，子路由内的所有规则直接被跳过，对匹配性能有正面帮助。

子路由也支持路径前缀。以 /products 为前缀创建子路由后，内部注册 / 对应 /products/，/{key}/ 对应 /products/{key}/，路径结构一目了然。

URL 反向构建

路由命名后，可以用 URL() 方法反向生成完整 URL：

go 复制代码

r.HandleFunc("/articles/{category}/{id:[0-9]+}", ArticleHandler).Name("article")
url, _ := r.Get("article").URL("category", "technology", "id", "42")
// 生成: /articles/technology/42

这个能力适合维护资源间的引用关系。路由路径调整后，不需要全局搜索字符串拼接位置。生成的 URL 会校验参数是否匹配路由定义的正则表达式，保证输出合法。对于包含主机名和查询参数的复杂路由，URLHost() 和 URLPath() 可以分别构建对应部分。

中间件与周边

mux 的中间件签名为 func(http.Handler) http.Handler，与 Go 社区主流中间件库保持一致。日志记录、认证鉴权、请求限流等逻辑通过 Router.Use() 注册，按添加顺序依次执行。如果中间件没有调用 next.ServeHTTP()，请求链会在此中断，适合做权限拦截。

mux 内置了 CORSMethodMiddleware，能自动根据路由上注册的 HTTP 方法设置 Access-Control-Allow-Methods 响应头。README 中还提供了静态文件服务、SPA 单页应用部署、优雅关闭的完整代码示例，覆盖了一个 Web 服务从开发到部署的典型路径。

适用场景

用 Go 写 HTTP 服务，路由逻辑超出了标准库的覆盖范围时，mux 是一个稳妥的选择。API 风格贴近标准库，没有引入新的抽象层，学习成本不高。源码体量适中，团队自己维护也没有负担。对于不想引入完整 Web 框架、只需要一个灵活路由层的项目，mux 刚好处在这个位置。