#阅读指南

这套教程面向已经学过一点 Go 基础、第一次接触 Gin 框架的人。

Gin 是 Go 生态里常用的 HTTP Web 框架，适合写 REST API、后台接口和中小型 Web 服务。

#一、版本说明

本教程按 2026-06-07 的 Gin 官方文档整理。

当前 Gin v1.12.0 发布说明里，最低 Go 版本要求已经提升到 Go 1.24。

本教程只使用 Go Modules，不讲旧的 GOPATH 项目组织方式。

#二、学习顺序

建议按顺序阅读：

1. 快速入门：安装 Gin，写第一个接口，理解 gin.Context。
2. 路由和参数：GET、POST、路径参数、查询参数、路由分组。
3. 请求绑定和校验：JSON、表单、查询参数绑定，以及基础校验。
4. 响应和中间件：统一响应、错误处理、日志、鉴权中间件。
5. 测试和部署准备：接口测试、运行模式、优雅关闭。

#三、你需要先会什么

如果结构体和指针不熟，建议先看 Go 入门教程里的结构体和指针章节。

#四、官方资料

• Gin 官方文档：https://gin-gonic.com/docs/
• Gin GitHub：https://github.com/gin-gonic/gin
• Gin 示例仓库：https://github.com/gin-gonic/examples