它到底是「HTTP 框架 / Web 框架 / 微服务框架」里的哪一种？提供哪些功能？带不带 ORM？带不带依赖注入？各种 Web 开发要的功能齐不齐？最后和 go-zero 做一次完整定位对比。
✓ 算，但只是底层。Gin 建立在标准库 net/http 之上，封装了 HTTP 的请求路由与处理。说它「是 HTTP 框架」没错，但只说到它最底层。
✓ 最准确。它在 HTTP 之上加了路由、中间件、参数绑定、JSON 渲染、校验等Web 开发常用能力，并内置 Logger/Recovery。所以「Web 框架」是它最完整的标签。
✗ 不是。Gin 不含服务发现、熔断限流、链路追踪、配置中心、代码生成、gRPC。它是「单服务写好 API」的工具，不是「多服务治理」的工具。
基于 httprouter 风格的基数树，支持 :param 与 *wildcard，O(1) 级匹配、零内存分配。
r := gin.New() r.GET("/user/:id", h) // 路径参数 r.POST("/user", h) api := r.Group("/api/v1") // 路由组，统一管理前缀/中间件 api.GET("/orders", h)
链式 c.Next() / c.Abort()。内置 Logger、Recovery（panic 不挂服务）。鉴权/限流/CORS 全靠中间件组合。
r.Use(gin.Logger(), gin.Recovery()) // 全局 r.Use(AuthMiddleware()) // 自定义 func AuthMiddleware() gin.HandlerFunc { return func(c *gin.Context) { if !valid(c.GetHeader("Authorization")) { c.AbortWithStatusJSON(401, gin.H{"e":"unauthorized"}) return } c.Next() } }
自动把 JSON/表单/Query 绑定到 struct，并用 go-playground/validator 做校验（binding:"required"）。这是 Gin 比裸 net/http 爽很多的地方。
type Req struct { Name string `json:"name" binding:"required"` Age int `json:"age" binding:"gte=0,lte=150"` } var q Req if err := c.ShouldBindJSON(&q); err != nil { c.JSON(400, gin.H{"err": err.Error()}) return }
内置 JSON / XML / YAML / String / HTML(模板) / Data / File / Redirect。还有 SSE（c.Stream）、静态文件（Static）。
c.JSON(200, gin.H{"ok": true}) // 自动序列化 + Content-Type
c.HTML(200, "index.tmpl", data) // 走 html/template
c.File("./a.png")
r.Static("/assets", "./static")
c.Error / c.AbortWithError）、gin.Context 的键值存储（c.Set/c.Get 跨中间件传值）、优雅关闭（包一层 http.Server 调 Shutdown）、测试用 httptest 友好。
用一张表看 Gin「给」和「不给」：
| 能力 | Gin 是否提供 | 说明 |
|---|---|---|
| HTTP 路由 / 参数 | 提供 | Radix tree，:param / *wildcard |
| 中间件链 | 提供 | Logger / Recovery 内置 |
| JSON / 表单绑定 | 提供 | ShouldBind 系列 |
| 参数校验 | 提供 | via validator/v10 |
| JSON / XML / 模板渲染 | 提供 | c.JSON / c.HTML |
| 错误恢复 | 提供 | Recovery 中间件 |
| 静态文件 / SSE | 提供 | Static / Stream |
| ORM / 数据库 | 不提供 | 需外接 GORM / sqlx / ent |
| 依赖注入容器 | 不提供 | 手写构造注入 / 第三方 wire |
| 服务发现 / 负载均衡 | 不提供 | 微服务才需要，Gin 不管 |
| 熔断 / 限流 | 部分 | 需自己写/接限流中间件，无熔断 |
| 链路追踪 / 指标 | 部分 | 靠 otel 等中间件，非内置 |
| 代码生成 | 不提供 | 无 goctl 这类工具 |
| gRPC / 多协议 | 不提供 | 仅 HTTP |
Gin 完全不含数据库层。它只管「请求进来、响应出去」，数据库你怎么连、怎么映射它不管。这也是大多数轻量 Web 框架的通行做法（关注点分离）。
典型做法：自己选 ORM 接到 Gin 里，比如 GORM（最流行）、sqlx（轻量）、ent（代码生成型）：
import "gorm.io/gorm" var db *gorm.DB // 在 main 里初始化一次 r.GET("/user/:id", func(c *gin.Context) { var u User db.First(&u, c.Param("id")) // 直接用 GORM，Gin 不掺和 c.JSON(200, u) })
goctl model 生成一套带缓存的 Model 代码（usermodel_gen.go），你直接调用；而 Gin 这边连 Model 都要你自己引 GORM 写。这是「生成 vs 手写」的差别，不是「有 vs 无」——但体验上 go-zero 把数据库这层也顺手管了。
这里要分清两个「依赖管理」：
go mod init / go get 管理的是整个项目的第三方包，不是 Gin 的功能。type Server struct{ DB *gorm.DB }，方法当 handler；// 闭包捕获：把 db 注入 handler（Gin 不帮你，你自己写） func NewUserHandler(db *gorm.DB) gin.HandlerFunc { return func(c *gin.Context) { var u User; db.First(&u, c.Param("id")) c.JSON(200, u) } }
ServiceContext 做编译期、无反射的依赖装配（svc.NewServiceContext 集中把 db / rpc client / config 一次性注入，所有 logic 通过 svcCtx 取用）。Gin 没有这个约定，你爱怎么注入怎么注入——灵活，但大项目容易各自为政、缺统一规范。
核心 Web 功能：有。路由、绑定、校验、JSON、中间件、错误恢复、静态文件、SSE、测试——写一个标准 REST API 所需的基本都齐了，这也是它流行的原因。
但「生产级 Web 服务」要的另一些东西：要自己拼。
gorilla/websocket；ulule/limiter 等中间件；otelhttp 等（好在 Gin 基于 net/http，兼容好）；| 维度 | Gin | go-zero |
|---|---|---|
| 框架类型 | Web / HTTP 框架（路由型） | 微服务框架 |
| 解决的问题层 | 单服务怎么写好 HTTP 接口 | 多个服务怎么协作 + 怎么写好接口 |
| 底层 | net/http | net/http（rest）+ gRPC（zrpc） |
| 路由 / 绑定 / JSON | 提供 | 提供（生成出来也用） |
| ORM | 无（接 GORM） | 生成 Model（goctl model） |
| 依赖注入 | 无容器（手写） | ServiceContext 编译期注入 |
| 代码生成 | 无 | goctl（.api/.proto/SQL） |
| 服务发现 / 负载均衡 | 无 | 内置（etcd 等） |
| 熔断 / 限流 / 降级 | 无 | 内置全套 |
| 链路追踪 / 指标 | 需外接 | 内置（traceId / Prometheus） |
| 多协议 | 仅 HTTP | HTTP + gRPC |
| 配置 / 多环境 | 自己写 | 多 yaml + -f + ${ENV} |
| 学习曲线 | 低（几天上手） | 中~高（有目录约定） |
| 灵活性 | 高（爱怎么写怎么写） | 中（约定优于配置） |
| 最适合 | 通用 API / 单体 / 轻服务 | 微服务从 0 / 要治理 |