用 Gin 构建 RESTful API 核心三步:初始化路由、定义 HTTP 方法和路径、绑定处理函数;它轻量高性能,适合中小项目快速上线。

用 Gin 构建 RESTful API 很快,核心就三步:初始化路由、定义 HTTP 方法和路径、绑定处理函数。它轻量、高性能,适合中小项目快速上线。
初始化 Gin 项目并启动服务
先安装 Gin:go get -u github.com/gin-gonic/gin。新建 main.go,写最简服务:
- 调用 gin.Default() 获取带日志和恢复中间件的路由器
- 用 .Run(":8080") 启动,端口可自定义
- 默认开启调试模式(控制台输出彩色日志),部署时设环境变量 GIN_MODE=release
定义 RESTful 路由与处理函数
Gin 支持标准 HTTP 方法映射,路径参数和查询参数提取非常直观:
- 路径参数用冒号声明,如 GET /users/:id → c.Param("id") 获取
- 查询参数如 /users?page=1&size=10 → c.Query("page") 或 c.DefaultQuery("page", "1")
- JSON 请求体用 c.ShouldBindJSON(&struct) 自动解析,字段需加 JSON tag
返回标准 JSON 响应
Gin 提供了简洁的响应封装,避免手动设置状态码和 Content-Type:
立即学习“go语言免费学习笔记(深入)”;
- c.JSON(200, gin.H{"code": 0, "data": user}) —— 快速返回结构化数据
- 统一错误响应建议封装成函数,例如 ctx.ErrorResp(400, "invalid id")
- 需要返回空响应或重定向时,用 c.Status(204) 或 c.Redirect(302, "/login")
添加中间件做基础增强
实际项目中加几个常用中间件就能提升健壮性:










