1. 路由组的基本特性
在深入讨论之前，我们需要了解Gin路由组的基本特性：
- 模块化：路由组允许我们将相关路由集中在一起，这有助于构建清晰、模块化的API结构。
- 中间件共享：路由组可以共享中间件，这意味着我们可以为一组路由指定通用的处理逻辑，如身份验证、日志记录等。
2. /v1 路由组
/v1通常代表API的一个版本。使用此路由组，可以为特定版本的API集中管理所有路由。
2.1 特性
- 版本管理：通过以版本号命名（如
/v1），清晰地表明了API的版本，有助于API版本迭代和管理。 - 中间件共享：
/v1路由组下的所有路由都可以共享中间件，这使得版本控制和特定的请求处理逻辑变得容易。
2.2 示例
v1 := router.Group("/v1")
{
v1.GET("/users", usersHandler)
v1.POST("/users", createUserHandler)
}
在此示例中，所有用户相关的路由都在/v1组下，它们可以共享例如认证、权限检查的中间件。
3. /v1/system 路由组
/v1/system是一个更具体的路由组，通常用于处理系统级别的API请求，如系统状态、配置等。
3.1 特性
- 特定功能聚焦：与
/v1相比，/v1/system聚焦于系统相关的功能，使得路由更加专业化和细分。 - 继承和扩展：
/v1/system继承了/v1的所有特性（如版本管理和中间件），同时可以添加其特有的中间件或逻辑。
3.2 示例
system := v1.Group("/system")
{
system.GET("/status", systemStatusHandler)
system.POST("/config", updateConfigHandler)
}
在此示例中，所有系统级别的操作都在/v1/system下，它继承了/v1的中间件并可能有自己的特定逻辑。
4. 两者的区别
- 路径层级：
/v1是一个基础层级，代表了API的一个主要版本；而/v1/system是更具体的子层级，专注于系统相关功能。 - 功能聚焦：
/v1适合作为更广泛的功能集的基础，如用户管理、订单处理等；而/v1/system更适合特定的、通常是低级的系统功能。 - 中间件和处理逻辑：虽然两者都可以使用中间件，但
/v1/system可以在继承/v1的中间件基础上进一步添加特定的逻辑。
5.优先级
在Gin框架中，路由的匹配是基于首先遇到的最精确匹配原则进行的。这意味着Gin在处理请求时会从注册的路由中找到最先匹配的一个。因此，理论上讲，更具体的路由（即路径更长或更复杂的路由）通常会有更高的优先级。这是因为它们提供了更精确的匹配条件。
在前面的例子中，/v1/system本身就因为更具体，相对于/v1而言，在Gin的路由匹配机制中自然拥有更高的优先级。当我们定义了这两个路由组时，任何发送到/v1/system的请求都会被/v1/system路由组中的路由处理，而不会落到/v1上。这是因为/v1/system提供了更精确的匹配。
router := gin.Default()
// 定义/v1路由组
v1 := router.Group("/v1")
{
v1.GET("/", v1Handler) // 处理 /v1
}
// 定义/v1/system路由组，它自然拥有比/v1更高的优先级
v1System := router.Group("/v1/system")
{
v1System.GET("/", v1SystemHandler) // 处理 /v1/system
}
**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**
**[需要这份系统化的资料的朋友，可以添加戳这里获取](https://gitee.com/vip204888)**
**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**
