2. Gin框架入门：Gin框架简介、安装Gin、路由基础、启动HTTP服务

2.1 Gin框架简介

Gin 是用 Go 语言编写的开源 Web 框架，以极致的性能和简洁的 API 设计著称。它基于 httprouter 实现高效路由，并内置了中间件链、请求参数绑定、验证、渲染等常用功能，是构建微服务、RESTful API 和压测目标应用的首选框架之一。

2.2 安装 Gin

Gin 的安装依赖 Go 模块系统，确保 Go 版本 ≥ 1.16。推荐使用 go get 命令安装最新稳定版。

# 初始化 Go 模块（如果尚未初始化）
go mod init gin-demo

# 安装 Gin 框架
go get -u github.com/gin-gonic/gin

# 验证安装（查看 go.mod 中是否出现 gin 依赖）
cat go.mod

2.3 路由基础

Gin 的路由基于 Radix Tree（压缩前缀树） 实现，支持精确匹配、参数匹配、通配符匹配。路由注册使用 GET、POST、PUT、DELETE 等方法，也可使用 Any 匹配所有 HTTP 方法。

package main

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

func main() {
    r := gin.Default()

    // 精确匹配
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "pong",
        })
    })

    // 参数匹配
    r.GET("/user/:id", func(c *gin.Context) {
        id := c.Param("id")
        c.String(http.StatusOK, "User ID: %s", id)
    })

    // 通配符匹配
    r.GET("/files/*path", func(c *gin.Context) {
        path := c.Param("path")
        c.String(http.StatusOK, "File path: %s", path)
    })

    // 启动服务
    r.Run(":8080")
}

2.4 启动 HTTP 服务

Gin 通过 r.Run() 启动 HTTP 服务，默认监听 :8080。支持自定义地址、TLS 配置、优雅关闭等高级用法。

// 完整示例：启动 HTTP 服务并处理请求
package main

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

func main() {
    // 创建默认路由引擎（包含 Logger 和 Recovery 中间件）
    router := gin.Default()

    // 注册路由
    router.GET("/", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "status":  "running",
            "version": "1.0.0",
        })
    })

    // 启动服务
    log.Println("Server starting on :8080")
    if err := router.Run(":8080"); err != nil {
        log.Fatalf("Failed to start server: %v", err)
    }
}

2.5 本章小结

• Gin 框架 以高性能 Radix Tree 路由和简洁 API 著称，适合作为压测目标服务。
• 安装 使用 go get -u github.com/gin-gonic/gin，注意配置 Go 代理。
• 路由基础 支持精确匹配、参数匹配（:param）、通配符匹配（*path）。
• 启动服务 调用 r.Run(":port")，支持 HTTPS 和自定义地址。
• 请求处理流程 为：请求 → 中间件链 → 路由匹配 → Handler 执行 → 响应返回。