Go标准库net/http不支持路由分组，需借助gorilla/mux的Subrouter()、gin的Group()或手动封装ServeMux实现；前者支持嵌套与独立中间件，后者更简洁但绑定框架上下文，自定义方案则灵活性低且需手动处理路径前缀。
Go 标准库 net/http 本身不提供路由分组能力，必须依赖第三方路由器（如 gorilla/mux、gin、echo）或手动封装。直接用 http.ServeMux 无法嵌套路径前缀并统一中间件，硬写会导致重复逻辑和维护困难。
gorilla/mux 中用 Subrouter() 实现嵌套路由分组
gorilla/mux 是最接近标准库风格的成熟路由库，其 Subrouter() 方法是实现分组的核心。它返回一个独立子路由器，可单独挂载中间件、设置路径前缀，并与父路由共享部分配置。
- 子路由的
PathPrefix("/api")不会自动加斜杠结尾，/api/users和/api/users/被视为不同路径，需显式处理 - 中间件在子路由上调用
Use()仅影响该子树，不影响其他路由 - 子路由可继续调用
Subrouter()构建多层嵌套，但过深会降低可读性，建议控制在 2–3 层
router := mux.NewRouter()
api := router.PathPrefix("/api").Subrouter()
api.Use(authMiddleware, loggingMiddleware)
v1 := api.PathPrefix("/v1").Subrouter()
v1.HandleFunc("/users", listUsers).Methods("GET")
v1.HandleFunc("/users/{id}", getUser).Methods("GET")
gin 框架中用 Group() 管理路由前缀与中间件
gin.Engine.Group() 更简洁，返回的 *gin.RouterGroup 可链式注册路由，且自动处理前缀拼接（包括末尾斜杠归一化）。但它绑定的是 gin 特有上下文，无法混用标准 http.Handler。
-
Group()第二个参数传入中间件函数，多个中间件按顺序执行，任一返回即中断 - 路径中若含变量（如
:id），必须用gin.Param()获取，不能用req.URL.Query().Get() - 同一前缀下混合使用
GET、POST等方法时，别名如router.POST("/login", loginHandler)不能写成group.POST后再设前缀——前缀已在Group()中声明
r := gin.Default()
api := r.Group("/api")
api.Use(AuthMiddleware(), Recovery())
{
v1 := api.Group("/v1")
{
v1.GET("/users", ListUsers)
v1.POST("/users", CreateUser)
v1.GET("/users/:id", GetUser)
}
}
自定义分组：用闭包封装 http.ServeMux + 前缀匹配
若坚持不用第三方库，可通过包装 http.ServeMux 并结合 http.StripPrefix 手动模拟分组。但要注意：标准 ServeMux 不支持通配符或变量提取，所有路径匹配都是静态前缀判断。
立即学习“go语言免费学习笔记（深入）”；
- 必须用
http.StripPrefix()剥离前缀，否则子 handler 收到的r.URL.Path仍带原始前缀，导致内部路由失败 - 无法为不同子组设置差异化中间件，只能靠外层
http.Handler统一拦截，灵活性极低 - 遇到
/admin/和/admin（无尾部斜杠）时行为不一致，需额外判断r.URL.Path == "/admin"并重定向
func NewGroupedMux(prefix string, h http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if !strings.HasPrefix(r.URL.Path, prefix) {
http.NotFound(w, r)
return
}
r2 := new(http.Request)
*r2 = *r
r2.URL = new(url.URL)
*r2.URL = *r.URL
r2.URL.Path = strings.TrimPrefix(r.URL.Path, prefix)
http.StripPrefix(prefix, h).ServeHTTP(w, r2)
})
}
mux := http.NewServeMux()
mux.HandleFunc("/list", listHandler)
adminMux := http.NewServeMux()
adminMux.HandleFunc("/dashboard", dashboardHandler)
http.Handle("/admin/", NewGroupedMux("/admin/", adminMux))
真正难的不是怎么写分组，而是决定哪些逻辑该放进分组、哪些该抽成中间件、以及变量命名是否在所有层级保持一致——比如 {user_id} 在 API 分组里叫 id，到了管理后台又变成 uid，后续联调就会卡住。
