Gin快速安装与入门

Gin快速安装与入门

前置条件

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

文章目录

  • Gin快速安装与入门
    • 前置条件
    • [第一步:安装 Gin 并初始化项目](#第一步:安装 Gin 并初始化项目)
    • [第二步:创建你的第一个 Gin 应用](#第二步:创建你的第一个 Gin 应用)
    • [第三步:运行你的 API 服务器](#第三步:运行你的 API 服务器)
    • [附加示例:在 Gin 中使用 net/http](#附加示例:在 Gin 中使用 net/http)

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

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

Terminal 复制代码
mkdir gin-quickstart && cd gin-quickstart

go mod init gin-quickstart

添加 Gin 作为依赖:

Terminal 复制代码
go get -u github.com/gin-gonic/gin

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

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

Terminal 复制代码
touch main.go

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

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 服务器

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

Terminal 复制代码
go run main.go

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

Terminal 复制代码
{"message":"pong"}

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

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

go 复制代码
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()
}