快速入门

如果你刚开始用 Go 语言做 Web 开发,可能会好奇该选择哪个框架。Gin 是目前 Go 社区中最受欢迎的 Web 框架之一,GitHub 上有超过 70k 的 star。

为什么这么多人选择 Gin?答案很简单:它足够快,API 设计得足够简洁,文档也足够完善。无论你是想构建一个简单的 API 服务,还是复杂的微服务架构,Gin 都能胜任。

这一部分我们会从零开始,带你了解 Gin 是什么、如何安装、以及如何写出第一个能跑起来的 Web 服务。不用担心,整个过程不会很复杂,跟着步骤来就行。

前提条件

Go 版本:Gin 需要 Go 版本 1.24 或更高 请确保 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() // 默认监听 0.0.0.0:8080
}

第三步:运行你的 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()
}