路由组前缀必须以单斜杠开头且无尾部斜杠，否则导致404；group()创建子路由器而非字符串拼接；中间件不自动继承，需显式挂载；通配符与静态路径同级注册会panic；建议按业务模块拆分路由并命名清晰。
路由组前缀必须严格以单斜杠开头且不带尾部斜杠
写错前缀格式是 404 的最常见原因。Gin 的 Group() 不是字符串拼接，而是创建子路由器，前缀必须符合路径规范。
-
r.Group("/api/v1")✅ 正确：单个开头/，无多余斜杠 -
r.Group("api/v1")❌ 路径注册失败，实际匹配GET /api/v1/users会 404 -
r.Group("/api/v1/")❌ 注册v1.GET("/users", h)变成/api/v1//users，部分 Gin 版本直接 panic -
v1 := r.Group("/api/v1")后，子路由必须写v1.GET("/users", h)，不能写v1.GET("/api/v1/users", h)（否则变成双重前缀）
嵌套路由组必须显式挂载中间件，不会自动继承
分组本身不携带任何中间件逻辑，哪怕你在根路由调用了 r.Use(JWTAuth())，所有子组仍裸奔。
- 父组挂了中间件，子组不自动获得：
v1.Use(AuthMiddleware())→admin := v1.Group("/admin")→ 必须再写admin.Use(LogMiddleware()) - 链式写法
v1.Group("/admin").Use(B()).GET("/x", h)看似简洁，但调试时堆栈难定位；推荐显式变量命名，便于排查作用域 - 中间件执行顺序严格按注册顺序叠加：全局
r.Use(A())+ 分组admin.Use(B())→ 请求流为A → B → handler - 权限中间件里漏掉
c.Abort()，会导致后续 handler 仍执行（比如删库操作照常发生）
通配符分组和静态路径同级注册会直接 panic
Gin 路由树对冲突极其敏感，同一层级下不允许通配符与完全匹配的静态路径共存。
-
r.Group("/api/:version")创建后，再注册GET("/api/v1/users")→ 触发wildcard route conflicts with existing child - 想支持多版本又保留明确路径，就别用通配符分组，改用多个静态分组：
r.Group("/api/v1")、r.Group("/api/v2") - 通配符路径（如
/files/*filepath）应放在分组末尾，避免与/files/upload同级注册 - 分组只管路径前缀隔离，不提供任何安全语义——光靠路径叫
/admin就以为有权限，是线上事故高发点
中大型项目建议把分组逻辑拆到独立函数中管理
三级以上嵌套（如 r.Group("/v1").Group("/user").Group("/profile")）会让代码可读性断崖式下降，且难以测试和复用。
- 把用户相关路由抽成函数：
func registerUserRoutes(rg *gin.RouterGroup)，再传入v1.Group("/users") - 按业务模块分文件：每个
xxx_routes.go文件只负责一个分组，init()或显式调用注册函数 - 避免在 main 函数里堆砌所有
Group()和Use()，否则修改一个中间件要翻遍整个文件 - 分组变量名要有业务含义（如
adminAPI、publicV1），而不是g1、grp这类无意义命名
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
