Gin快速安装与入门

前置条件

  • Go 版本：Gin 需要 Go 1.25 或更高版本
  • 确认 Go 在你的 PATH 中并且可以从终端使用。有关 Go 安装帮助，请参阅官方文档。

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

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

window
1
2
3
mkdir gin-quickstart && cd gin-quickstart

go mod init gin-quickstart

添加 Gin 作为依赖：

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

image-20260620111905487

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

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

window
1
touch main.go

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

1
2
3
4
5
6
7
8
9
10
11
12
13
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 服务器

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

window
1
go run main.go

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

window
1
{"message":"pong"}

附加示例：在 Gin 中使用 net/http

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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()
}