直接用 echo.Group() 配合显式传入 *echo.Echo 实例即可拆分路由，需按业务建 routes/ 目录、每模块一个注册函数，中间件必须在 Group() 后立即链式调用，且路由与 handler 应分离存放。

直接用 echo.Group() 配合函数封装就能拆，不用任何第三方包，也不需要修改框架行为。

路由分组必须显式传入 *echo.Echo 实例

很多人卡在第一步：把路由逻辑写进单独文件后，e.GET() 报错说 e 未定义。根本原因是没把 *echo.Echo 实例传进去。

• 错误写法（闭包捕获外部变量，但无法跨文件）：func SetupUserRoutes() { e.GET(...) }
• 正确写法（显式接收）：func SetupUserRoutes(e *echo.Echo) { e.GET(...) }
• 调用时必须传实例：SetupUserRoutes(e)，不能漏掉 e

按业务模块建 routes/ 目录 + 每个文件一个注册函数

比如用户相关路由全放 routes/user.go，订单放 routes/order.go，避免混在一起。

网盘文件管理

在 Mac 本地通过 AList WebDAV 管理百度网盘与夸克网盘，并用 Agent 执行服务启动、状态检查、Finder 挂载、流式上传下载及确认后删除。Use when Codex needs to manage the user's local Baidu/Quark cloud-drive workf...

下载

• 目录结构示例：routes/user.go、routes/order.go、main.go
• user.go 内容：

  package routes
  
  import "github.com/labstack/echo/v4"
  
  func SetupUserRoutes(e *echo.Echo) {
      u := e.Group("/users")
      u.GET("", listUsers)
      u.GET("/:id", getUser)
      u.POST("", createUser)
  }

• 在 main.go 中统一调用：routes.SetupUserRoutes(e)、routes.SetupOrderRoutes(e)

带中间件的路由组要提前声明，别在函数里重复创建

如果某组路由需要统一加 JWT 鉴权或日志，中间件必须在 Group() 后立刻链式调用，不能等函数返回后再加。

• 错误：

  u := e.Group("/admin")
  SetupAdminRoutes(u) // 这里 u 已经是普通 Group，没中间件
  u.Use(middleware.JWT(...)) // 太晚了，对已注册的路由无效

• 正确：

  u := e.Group("/admin")
  u.Use(middleware.JWT(...))
  SetupAdminRoutes(u) // 中间件已绑定，所有子路由自动继承

• 注意：Use() 必须在任何 GET/POST 之前调用，顺序敏感

别把路由和 handler 函数混在一个文件里

拆文件不是为了“看起来多”，而是为了隔离变更影响。handler 函数建议放到 handlers/ 下，和路由注册分离。

• 好处：改一个接口逻辑，只动 handlers/user.go，不动 routes/user.go
• 例如：listUsers 是个函数名，它本身可以定义在 handlers/user.go，只要 routes/user.go import 正确就行
• 避免循环 import：如果 handlers/ 需要用到 echo.Context，就直接 import github.com/labstack/echo/v4，不依赖 routes/

最常被忽略的是 Group 的生命周期——它不是“注册完就结束”，而是一直持有中间件和子路由引用。一旦在某个地方误删了 u.Use(...) 或把 Group() 写成 e.GET()，整组路由就脱离了预期控制流。