一、前置条件

Go 版本：Gin 需要 Go 1.25 或更高版本

确认 Go 在你的 PATH 中并且可以从终端使用

二、快速入门

①、第一步：安装 Gin 并初始化项目

首先创建一个新的项目文件夹并初始化 Go 模块：

mkdir gin-quickstart && cd gin-quickstart
go mod init gin-quickstart

添加 Gin 作为依赖：

go get -u github.com/gin-gonic/gin

②、第二步：创建你的第一个 Gin 应用

创建一个名为 main.go 的文件：

touch main.go

打开 main.go 并添加以下代码：

package main

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

func main() {
  router := gin.Default()
  router.GET("/ping", func(c *gin.Context) {
    c.JSON(200, gin.H{
      "message": "pong",
    })
  })
  router.Run() // listens on 0.0.0.0:8080 by default
}

③、第三步：运行你的 API 服务器

使用以下命令启动服务器：

go run main.go

在浏览器中访问 http://localhost:8080/ping，你应该会看到：

{"message":"pong"}

④、在 Gin 中使用 net/http

如果你想使用 net/http 的响应码常量，也需要将其导入：

package main

import (
  "github.com/gin-gonic/gin"
  "net/http"
)

func main() {
  router := gin.Default()
  router.GET("/ping", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
      "message": "pong",
    })
  })
  router.Run()
}