Gin 系列教程 (01)：为什么是 Gin，以及它解决了什么问题

用 Go 写 HTTP 服务，标准库 net/http 已经够用了。路由注册、Handler 接口、中间件链——基本能力都有。那为什么还需要 Gin？

这个问题值得先想清楚，再决定要不要引入一个框架依赖。

---

标准库的边界在哪里

net/http 的路由匹配是前缀树的简单实现，不支持路径参数。写 /users/:id 这种风格的路由，需要自己解析 URL、手动提取参数。

// 标准库的方式
http.HandleFunc("/users/", func(w http.ResponseWriter, r *http.Request) {
    id := strings.TrimPrefix(r.URL.Path, "/users/")
    // 还要自己处理尾部斜杠、空字符串等边界情况
})

这不是不可以，但量一大就变成体力活。更麻烦的是中间件组合——标准库没有原生的中间件链概念，要自己封装 http.Handler，每加一层都是手工嵌套。

Gin 解决的核心问题就是这两个：路由匹配 和 中间件编排。

---

Gin 的设计选择

Gin 底层用的是 httprouter——一个基于 Radix Tree 的路由实现，路径参数提取是内置能力，不需要你来处理字符串解析。

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

gin.Context 是 Gin 的核心抽象。它把请求读取、参数绑定、响应写入、元数据传递都收敛到一个对象里，中间件和 Handler 共享同一个上下文，不需要通过 context.WithValue 传递自定义数据。

中间件链的写法也很直接：

r := gin.New()

// 全局中间件
r.Use(gin.Logger(), gin.Recovery())

// 分组中间件
api := r.Group("/api", AuthMiddleware())
api.GET("/profile", getProfile)

这和 net/http 的手工嵌套相比，代码结构清晰很多。

---

现代项目的起步方式

Go 1.11 之后，依赖管理统一到了 Go Modules，不再需要 govendor、dep 这类工具。

mkdir myproject && cd myproject
go mod init github.com/yourname/myproject
go get github.com/gin-gonic/gin

最小可运行示例：

package main

import (
    "net/http"

    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default() // 默认带 Logger 和 Recovery 中间件

    r.GET("/ping", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"message": "pong"})
    })

    r.Run(":8080")
}

gin.Default() 和 gin.New() 的区别值得注意：Default() 预装了 Logger 和 Recovery 中间件，适合快速起步；生产环境通常用 gin.New() 加自定义中间件，避免 Gin 的日志格式和你的日志系统冲突。

---

什么时候不需要 Gin

如果服务只有几个端点，逻辑简单，用标准库完全够，引入框架只是增加依赖。

Gin 的价值在路由复杂、中间件需要精细编排的场景下才真正体现出来。如果你在写的是内部工具或者单一职责的微服务，net/http + 少量辅助函数是更轻的选择。

---

这个系列后续会覆盖 Gin 的参数绑定与校验、中间件机制、错误处理模式，以及在实际项目中的结构组织方式。