路由分组是将具有相同前缀或共享中间件的路由归为一组，便于统一管理。使用 gorilla/mux 的 PathPrefix 和 Subrouter 方法可实现分组，如将 /api/v1/users 和 /api/v1/products 归入 /api/v1 组，或为 /admin 路由绑定认证中间件。通过 Subrouter 可为分组统一设置中间件、HTTP 方法、路径参数约束等，提升代码结构清晰度与可维护性，适用于中大型项目。
在Go语言中构建Web服务时，gorilla/mux 是一个功能强大的HTTP路由器，支持动态路由、变量匹配、路由分组、中间件绑定等高级功能。使用它能更方便地组织API结构，尤其是实现路由分组，可以让代码结构更清晰，适合中大型项目。
什么是路由分组？
路由分组是指将具有相同前缀或共享中间件的路由归为一组，便于统一管理。比如：
- /api/v1/users 和 /api/v1/products 可以归为 /api/v1 组
- 需要身份验证的接口归为一个组，绑定认证中间件
- 静态资源和API接口分离管理
安装 gorilla/mux
使用以下命令安装 mux 包：
go get github.com/gorilla/mux基本路由分组实现
通过 mux 的 PathPrefix 或 Subrouter 方法可以创建路由分组。下面是一个使用 Subrouter 实现API版本分组的示例：
立即学习“go语言免费学习笔记（深入）”；
package mainimport (
"net/http"
"github.com/gorilla/mux"
)
func main() {
r := mux.NewRouter()
// v1 API 分组
v1 := r.PathPrefix("/api/v1").Subrouter()
v1.HandleFunc("/users", getUsersV1).Methods("GET")
v1.HandleFunc("/users/{id}", getUserV1).Methods("GET")
// v2 API 分组
v2 := r.PathPrefix("/api/v2").Subrouter()
v2.HandleFunc("/users", getUsersV2).Methods("GET")
http.ListenAndServe(":8080", r)
}
func getUsersV1(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("v1 users list"))
}
func getUserV1(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
id := vars["id"]
w.Write([]byte("get user v1: " + id))
}
func getUsersV2(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("v2 users list"))
}
在这个例子中，/api/v1/users 和 /api/v2/users 被清晰地分组管理，结构一目了然。
为分组绑定中间件
路由分组的另一个强大功能是能为整个组绑定中间件。例如，为所有 /admin 路由添加身份验证：
// admin 分组，带认证中间件
admin := r.PathPrefix("/admin").Subrouter()
admin.Use(authMiddleware) // 所有 /admin 下的路由都经过此中间件
admin.HandleFunc("/dashboard", dashboardHandler).Methods("GET")
admin.HandleFunc("/users", adminUsersHandler).Methods("GET")
func authMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 模拟认证逻辑
token := r.Header.Get("Authorization")
if token == "" {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
next.ServeHTTP(w, r)
})
}
这样，所有 admin 分组下的路由都会自动执行认证检查，无需每个路由单独处理。
使用变量和约束的高级路由
gorilla/mux 支持路径参数和正则约束，可以在分组中灵活使用：
v1.HandleFunc("/users/{id:[0-9]+}", getUserV1).Methods("GET")这表示只匹配 id 为数字的请求，避免无效请求进入处理函数。
也可以使用 Queries 匹配查询参数：
v1.HandleFunc("/search").Queries("q", "{query}").Handler(searchHandler)总结
使用 gorilla/mux 的 Subrouter 和 PathPrefix 能轻松实现路由分组，配合中间件和路径约束，可构建结构清晰、易于维护的 Web 服务。分组不仅提升可读性，也便于权限控制、版本管理与模块化开发。
基本上就这些，不复杂但容易忽略细节。掌握这些技巧后，你的Go Web项目会更专业。
