本文介绍如何使用 gorilla mux 的 `subrouter()` 实现 `/my/*` 等子路径的模块化路由管理，将不同业务域的路由与处理器解耦到独立包中，提升大型 go web 项目的可维护性与可扩展性。
在构建中大型 Go Web 应用时，随着 API 接口数量增长（如 /my_post_01、/my_get_02 等），将全部路由硬编码在 main 包中会导致代码臃肿、职责不清、难以协作与测试。Gorilla Mux 提供了强大的 子路由器（Subrouter） 机制，配合 Go 的包初始化机制，可优雅实现路由的模块化拆分。
核心思路是：为公共前缀（如 /my）创建专用子路由器，并将其导出为包级变量；各业务包通过 init() 函数向该子路由器注册自身路由。这样既保持了路由声明的集中可控性，又实现了逻辑隔离。
✅ 推荐结构示例
首先，定义统一的路由中心包（例如 pkg/router）：
// pkg/router/router.go
package router
import "github.com/gorilla/mux"
var Router = mux.NewRouter()
var MyRouter = Router.PathPrefix("/my").Subrouter() // 所有 /my/* 路由挂载于此接着，在业务模块包（如 pkg/myapi）中注册具体路由：
// pkg/myapi/register.go
package myapi
import (
"net/http"
"your-app/pkg/router" // 导入路由中心
)
func myHandler1(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("POST /my/post_01"))
}
func myHandler2(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("GET /my/get_01"))
}
// init 在包导入时自动执行，完成路由绑定
func init() {
router.MyRouter.Methods("POST").Path("/post_01").HandlerFunc(myHandler1)
router.MyRouter.Methods("GET").Path("/get_01").HandlerFunc(myHandler2)
// 可继续添加 /post_02、/get_02... 无需修改主路由文件
}最后，在 main.go 中仅需挂载顶层路由器即可：
// main.go
package main
import (
"log"
"net/http"
"your-app/pkg/router" // 触发所有 init()，自动注册子路由
)
func main() {
// 所有子包的 init() 已执行，MyRouter 已填充完整
http.Handle("/", router.Router)
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}⚠️ 注意事项与最佳实践
- init() 的调用顺序不可控：确保各业务包之间无强依赖。若需严格顺序（如中间件前置），建议改用显式注册函数（如 myapi.Register(router.MyRouter)），并在 main() 中按需调用。
- 路径匹配优先级：Subrouter() 创建的子路由会继承父路由器的匹配规则，且子路由路径必须以 / 开头（如 .Path("/post_01")，而非 "/my/post_01"）。
- 避免重复注册：每个子路由应唯一。可通过单元测试或启动时日志校验 MyRouter.Walk() 遍历所有注册项。
-
支持嵌套子路由：对于更复杂结构（如 /my/v1/users），可进一步链式调用：
UsersRouter := router.MyRouter.PathPrefix("/v1/users").Subrouter() UsersRouter.Methods("GET").Path("").HandlerFunc(listUsers)
通过这种模式，你不仅能轻松支持 /my/* 的通配需求，还能横向扩展 /admin/*、/api/v2/* 等多个命名空间，真正实现高内聚、低耦合的路由架构。
