Gin 是 Go Web 开发首选轻量框架，因其性能优、API 简洁、中间件灵活且贴近 Go 习惯；它不隐藏 HTTP 细节，用 gin.Context 统一生命周期，兼顾开发效率与控制力。
为什么 Gin 是 Go Web 开发的首选轻量框架
Gin 在性能、API 设计和中间件机制上比 net/http 原生更高效，又比 echo 或 fiber 更贴近 Go 习惯——它不隐藏 HTTP 处理细节，但用 gin.Context 统一了请求/响应生命周期。你不需要为路由分组、JSON 解析、参数绑定写重复逻辑，但也不会被强约束在某套 ORM 或配置体系里。
初始化项目与基础路由必须写的三行代码
别跳过 gin.SetMode(gin.ReleaseMode)。开发时默认是 DebugMode，会打印完整栈、自动重载（需额外装 air）、暴露敏感 header；上线前漏掉这句，等于把调试信息直接吐给生产用户。
- 用
go mod init example.com/myapp初始化模块 - 导入
"github.com/gin-gonic/gin"，然后写：
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() + 手动 Use()。
处理 JSON 请求体时最容易错的两件事
一是结构体字段没加 json tag 导致解析为空；二是没检查 c.ShouldBindJSON(&v) 返回的 error 就直接用 v —— 这会导致 panic 或静默失败。
立即学习“go语言免费学习笔记（深入）”；
- 结构体字段必须导出（首字母大写），且推荐显式声明 tag：
type User struct { Name string `json:"name"` Age int `json:"age"` } - 永远用
if err := c.ShouldBindJSON(&user); err != nil { c.AbortWithStatusJSON(400, gin.H{"error": err.Error()}); return } -
ShouldBindJSON会自动调用json.Unmarshal并校验 required 字段（如果用了binding:"required"）
静态文件和模板渲染怎么避免路径陷阱
Gin 不自动查找子目录，r.Static("/static", "./static") 只服务 ./static 下的文件，不会递归进 ./static/css 或 ./static/js —— 但其实它会，只要路径匹配。真正容易踩坑的是模板：Gin 默认不支持嵌套 {{template}}，且 LoadHTMLGlob 的 glob 模式必须包含完整路径，比如 r.LoadHTMLGlob("templates/**/*") 才能加载子目录下的 templates/user/index.html。
- 静态资源建议用
r.StaticFS("/assets", http.Dir("./assets"))替代Static，更可控 - 模板中引用子模板需确保路径相对于
LoadHTMLGlob的根目录，例如{{template "header.html" .}}要求header.html在 glob 匹配范围内 - 生产环境务必关闭
gin.DebugPrintRouteFunc，它会在启动时打印所有路由，可能泄露内部路径
最常被忽略的是：Gin 的 c.Redirect 默认用 302，如果需要 SEO 友好或状态明确，得显式写 c.Redirect(301, "/new-path")。
