gin 不支持链式 group().group() 调用，因 routergroup 是值类型，子 group 未挂载导致 panic 或静默失效；须手动拼接前缀（如 r.group("/api/v1")）或传指针参数注册路由。
r.Group("/api").Group("/v1") 这种链式写法会 panic），但可以通过手动拼接前缀 + 多次 Group() 调用，安全实现语义清晰的多层路由结构。
为什么不能链式调用 Group().Group()
Gin 的 RouterGroup 是一个值类型，每次调用 Group() 都返回新实例，且其内部只保存当前层级的 prefix 和中间件。直接 r.Group("/api").Group("/v1") 实际上是在临时 group 上再建子 group，但该子 group 并未挂载到主 router，最终注册时路径丢失，运行时报 panic: runtime error: invalid memory address 或静默失效。
- 错误写法：
v1 := r.Group("/api").Group("/v1")→v1不可被用于注册 handler - 正确逻辑：必须显式将每个层级 group 传给下一级注册函数，或手动拼接完整 prefix
- 本质是 Go 的值语义限制，不是 Gin bug，但容易误读文档示例
Group() 前缀拼接要手动做，别依赖“自动继承”
想得到 /api/v1/users 这类路径，不能指望子 group 自动叠加父级 prefix；必须明确指定完整前缀，或在封装函数里处理拼接逻辑。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 安全做法：用字符串拼接构造完整 prefix，再调用
Group()——apiV1 := r.Group("/api/v1") - 模块化写法：定义
RegisterUserRoutes(apiV1 *gin.RouterGroup)，内部只注册GET("", ...)和GET("/:id", ...)，不带前缀 - 若需动态拼接（如版本号来自配置），用
fmt.Sprintf("/api/%s/users", version)，再传给Group() - 切忌在子模块函数里重复写
/api/v1—— 这会破坏复用性，也违背分组本意
按业务+版本双维度分组时，中间件绑定要落在最内层
比如 /admin/v2/dashboard 需要鉴权，而 /public/v2/status 不需要，中间件不能挂在顶层 r.Group("/admin")，否则会污染无关路由。
- 正确顺序：先分大模块（
admin := r.Group("/admin")），再分版本（v2 := admin.Group("/v2")），最后绑中间件（v2.Use(AuthMiddleware())） - 错误模式：
admin.Use(AuthMiddleware())→ 所有/admin/*都强制鉴权，包括未来可能加的公开接口 - 更灵活的做法：把中间件作为参数传入注册函数，例如
RegisterAdminV2Routes(v2 *gin.RouterGroup, mw ...gin.HandlerFunc) - 注意：同一 group 多次调用
Use()会追加中间件，不会覆盖，但顺序敏感
跨文件路由注册时，RouterGroup 传参必须是地址传递
Go 中 gin.RouterGroup 是 struct 值类型，如果在模块文件中接收时用了指针声明但没传地址，会导致路由注册失败且无报错。
- 错误签名：
func RegisterRoutes(g gin.RouterGroup)→g是副本，所有GET/POST注册到副本上，主 router 看不到 - 正确签名：
func RegisterRoutes(g *gin.RouterGroup)，调用时写pkg.RegisterRoutes(&v1) - 更常见也更安全的写法：保持值接收（
func RegisterRoutes(g *gin.RouterGroup)），但调用方传v1（非指针）—— 因为v1本身是*gin.RouterGroup类型（Group()返回的是指针） - 验证方式：启动后 curl 对应路径返回 404？大概率是传参类型不匹配导致 handler 没挂上去
RouterGroup 的生命周期和所有权归属 —— 它不是“活”的上下文容器，而是注册动作的临时代理。一旦你离开那个 {} 作用域，没显式保存或传递出去的 group 就失效了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
