如果你刚开始用 Go 语言做 Web 开发,可能会好奇该选择哪个框架。Gin 是目前 Go 社区中最受欢迎的 Web 框架之一,GitHub 上有超过 70k 的 star。
为什么这么多人选择 Gin?答案很简单:它足够快,API 设计得足够简洁,文档也足够完善。无论你是想构建一个简单的 API 服务,还是复杂的微服务架构,Gin 都能胜任。
这一部分我们会从零开始,带你了解 Gin 是什么、如何安装、以及如何写出第一个能跑起来的 Web 服务。不用担心,整个过程不会很复杂,跟着步骤来就行。
Go 版本:Gin 需要 Go 版本 1.24 或更高 请确保 Go 已加入你的 PATH 并可在终端中使用。如需安装帮助请参阅官方文档。
先创建项目文件夹并初始化 Go 模块:
mkdir gin-quickstart && cd gin-quickstart
go mod init gin-quickstart
安装 Gin 依赖:
go get -u github.com/gin-gonic/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
}
go run main.go
在浏览器中访问 http://localhost:8080/ping ,你会看到:
{"message":"pong"}
如果需要用 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()
}