Go Academy · 课时

Gin 路由器与路由组

Q: 「Gin 路由器与路由组」这节课中我会学到什么？

引擎设置、路由组与路径参数 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

引擎设置、路由组与路径参数

第 1 / 4 课13 个步骤

Gin 路由器与路由组 是 CoddyKit 上的免费 Go Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

什么是 Gin？

Gin 是一个高性能的 Go HTTP Web 框架。它使用基数树路由器，提供中间件支持、JSON 绑定和验证，因此非常适合构建 REST API。

安装与基本设置

导入并创建 Gin 引擎：

go get github.com/gin-gonic/gin

package main

func main() {
    r := gin.Default()
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{"message": "pong"})
    })
    r.Run(":8080")
}

gin.Default 与 gin.New

gin.Default() 包含 Logger 和 Recovery 中间件。gin.New() 创建一个不带中间件的引擎——当您需要完全控制中间件时使用它。

路由方法

为 HTTP 方法注册路由：GET、POST、PUT、PATCH、DELETE、OPTIONS、HEAD 和任意方法：

r.GET("/users", listUsers)
r.POST("/users", createUser)
r.PUT("/users/:id", updateUser)
r.DELETE("/users/:id", deleteUser)

路径参数

使用 c.Param("name") 提取路径参数：

r.GET("/users/:id", func(c *gin.Context) {
    id := c.Param("id")
    c.JSON(200, gin.H{"id": id})
})

查询参数

使用 c.Query 和 c.DefaultQuery 读取查询参数：

page := c.DefaultQuery("page", "1")
limit := c.Query("limit") // "" if absent

路由组

使用 r.Group 将相关路由归入同一个前缀下。应用于路由组的中间件会影响其中的所有路由：

api := r.Group("/api/v1")
{
    api.GET("/users", listUsers)
    api.POST("/users", createUser)
    api.PUT("/users/:id", updateUser)
}

嵌套路由组

可以嵌套路由组，以实现更细粒度的组织：

admin := r.Group("/admin")
admin.Use(AdminAuth())
{
    admin.GET("/stats", getStats)
    admin.DELETE("/users/:id", deleteUser)
}

无路由或不允许使用该方法

使用 r.NoRoute 和 r.NoMethod 优雅地处理 404 和 405：

r.NoRoute(func(c *gin.Context) {
    c.JSON(404, gin.H{"error": "not found"})
})

静态文件

从目录提供静态文件：

r.Static("/static", "./public")
r.StaticFile("/favicon.ico", "./favicon.ico")

作为 http.Handler 的引擎

Gin 的 *gin.Engine 实现了 http.Handler，因此您可以将其与自定义 http.Server 一起使用来配置超时：

srv := &http.Server{Addr: ":8080", Handler: r, ReadTimeout: 5*time.Second}
srv.ListenAndServe()

快速检查

在 Gin 中使用路由组有什么优势？

在交互式课程中回答

回顾：Gin 路由器与路由组

关键要点：

gin.Default() 包含 Logger 和 Recovery；使用 gin.New() 进行自定义设置
使用 c.Param 处理路径参数；使用 c.Query 处理查询参数
使用 r.Group("/prefix") 共享前缀和中间件
Gin 实现了 http.Handler——可与自定义 http.Server 一起使用

免费开始

用 AI 导师学习 Go — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 51
课程: 203

免费开始学习查看完整课程

常见问题解答

「Gin 路由器与路由组」课时是免费的吗？

是的 — 「Gin 路由器与路由组」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「Gin 路由器与路由组」这节课中我会学到什么？

引擎设置、路由组与路径参数你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Gin 路由器与路由组」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy