gin 的 router.group() 前缀必须以 / 开头且不能重复斜杠，如 r.group("/api/v1") ✅；分组不继承中间件，需显式调用 .use()；变量路由和通配符语法不变；空分组和多层嵌套应避免，推荐按业务域平铺分组。
router.Group() 的前缀必须以 / 开头，且不能重复斜杠
很多开发者写 r.Group("api/v1") 或 r.Group("/api/v1/")，结果路由匹配失败或 404。Gin 的分组前缀是路径拼接逻辑，不是字符串拼接——它会把分组前缀和子路由路径原样组合，中间不自动补 /、也不去重。
-
r.Group("/api/v1")✅ 正确：v1.GET("/users", handler)→ 匹配/api/v1/users -
r.Group("api/v1")❌ 缺开头/：可能匹配到根路径下的api/v1/users（即/api/v1/users变成//api/v1/users或直接不匹配） -
r.Group("/api/v1/")❌ 末尾多/：某些 Gin 版本（尤其是 v1.9+）在 radix 树匹配时会因路径规范化行为导致/api/v1//users不匹配 - 嵌套分组也一样：
v1 := r.Group("/api/v1"); admin := v1.Group("/admin")→admin.GET("/logs")对应完整路径/api/v1/admin/logs，不是/api/v1//admin/logs
分组不继承中间件，Use() 必须显式调用
全局注册了 r.Use(JWTAuth(), Logging())，不代表 v1.Group("/api/v1") 里的路由自动受保护。Gin 的分组是独立的子路由器，中间件链必须手动挂载。
- 正确写法：
v1 := r.Group("/api/v1").Use(JWTAuth(), Logging()) - 错误假设：“我全局用了鉴权，/admin 路由自然就受限” → 实际上
r.Group("/admin")完全不受影响，除非你对它也调用.Use() - 多个中间件顺序敏感：
.Use(Recover(), JWTAuth(), RoleCheck("admin"))中，RoleCheck依赖JWTAuth写入的c.Get("user_role")，顺序反了会 panic 或跳过校验 - 漏掉
c.Abort()是致命问题：鉴权失败后若只返回 JSON 却没调用c.Abort()，后续 handler（如deleteUser）仍会执行
变量路由和通配符在分组内写法不变
分组不影响路径参数语法，:id 和 *filepath 的写法和根路由完全一致，Gin 的 radix 树在匹配时会统一处理。
-
v1.GET("/users/:id", getUser)→ 正确匹配/api/v1/users/123，c.Param("id")可取值 -
v1.GET("/files/*filepath", serveFile)→ 匹配/api/v1/files/a/b/c.txt，c.Param("filepath")返回/a/b/c.txt（含开头/） - 不要在分组前缀里塞变量：
r.Group("/tenant/:tid")是合法但危险的——所有子路由都会带上该变量，且无法被子分组覆盖；应改用中间件提取并校验租户 ID - 空字符串分组
r.Group("")虽然语法合法，但会让路由结构模糊，建议完全避免
高可扩展性靠分层 + 显式隔离，不是靠嵌套深度
有人以为“多套 Group 就是模块化”，结果写出 r.Group("/v1").Group("/admin").Group("/api").Group("/users") 这种四层嵌套，反而增加维护成本。真正可扩展的结构是按业务域平铺分组 + 显式复用中间件。
- 推荐模式：
auth := r.Group("/auth"); user := r.Group("/users"); order := r.Group("/orders")—— 各自独立，职责清晰 - 跨域中间件（如 CORS）通常只需挂到根路由
r.Use(Cors())，因为它是前置响应头操作，无需每组重复 - 版本控制建议用一级分组：
v1 := r.Group("/v1"); v2 := r.Group("/v2")，而不是r.Group("/api/v1")—— 更利于网关层做路径重写和灰度路由 - 注意：分组间路由隔离，但
c.Set()写入的上下文数据在同一次请求中全局共享；别在中间件里用c.Set("req_id", ...)后，又在另一个中间件里误读为c.MustGet()而不判空
/admin 前缀不会拦住非管理员请求——权限必须靠中间件里解析 token、查 DB、调用 c.Abort() 来实现。最容易被忽略的是：分组变量作用域共享但生命周期不隔离，同一个请求里不同分组的中间件看到的是同一个 *gin.Context 实例。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
