2. Go 语言环境搭建：Go SDK 安装、GOPATH 与 Go Modules 配置、常用 IDE 设置

在开始 Gin 框架的契约压测之前，必须搭建一个稳定、可复现的 Go 开发环境。本章将指导你完成从 SDK 安装到 IDE 调试配置的全流程，并重点对比 GOPATH 与 Go Modules 两种依赖管理模式，确保后续压测项目结构清晰、依赖可控。

2.1 Go SDK 安装与版本选择

Go 语言官方推荐从 https://go.dev/dl/ 下载对应操作系统的安装包。对于 Web 压测场景，建议使用 Go 1.21 及以上版本，以享受内置的 toolchain 管理和性能优化。

2.2 GOPATH 与 Go Modules 配置

Go 的依赖管理经历了从 GOPATH 到 Go Modules 的演进。在契约压测项目中，我们强制使用 Go Modules，因为它支持精确版本锁定、语义化版本控制，并且不要求项目代码必须放在 $GOPATH/src 下。

2.2.1 GOPATH 传统模式（了解即可）

• 环境变量： GOPATH 默认指向 $HOME/go（Linux/macOS）或 %USERPROFILE%\go（Windows）。
• 目录结构： src/（源码）、pkg/（编译对象）、bin/（可执行文件）。
• 痛点： 所有项目共享同一依赖副本，无法处理不同项目对同一包的不同版本需求。

2.2.2 Go Modules 现代模式（推荐）

• 启用方式： 设置环境变量 GO111MODULE=on（Go 1.16 之后默认开启）。
• 核心文件： go.mod（模块路径与依赖声明）、go.sum（依赖哈希校验）。
• 初始化命令： go mod init <module-name>，例如 go mod init github.com/yourname/gin-bench。
• 依赖管理： go get 添加依赖，go mod tidy 清理无用依赖。

2.3 常用 IDE 设置：VS Code 与 GoLand

高效的 IDE 配置能显著提升压测脚本的编写与调试效率。以下分别介绍 VS Code 和 GoLand 的关键设置。

2.3.1 VS Code 配置

1. 安装 Go 扩展： 在扩展市场搜索“Go”，安装由 Go 团队官方维护的扩展（发布者为“golang”）。
2. 启用语言服务器： 打开设置（Ctrl+,），搜索 go.useLanguageServer，勾选启用。语言服务器提供自动补全、跳转定义、重构等功能。
3. 配置 go.mod 识别： 确保工作区根目录包含 go.mod 文件，VS Code 会自动识别模块模式。
4. 调试配置： 创建 .vscode/launch.json，添加 Go 调试配置，设置 program 为入口文件路径。

2.3.2 GoLand 配置

1. SDK 设置： 打开 File > Settings > Go > GOROOT，添加已安装的 Go SDK 路径。
2. 模块代理： 在 Settings > Go > Go Modules 中，设置 Proxy 为 https://goproxy.cn,direct，并勾选 Enable Go Modules integration。
3. 运行配置： 右键点击 main.go，选择 Run 'go build main.go'，GoLand 会自动创建运行配置。
4. 性能分析工具： 利用 GoLand 内置的 CPU Profiler 和 Memory Profiler，可在压测过程中实时分析性能瓶颈。

2.4 环境验证：编写第一个 Gin 压测入口

完成上述配置后，通过一个简单的 Gin 服务验证环境是否就绪。该服务将作为后续压测的目标接口。

// main.go
package main

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

func main() {
    r := gin.Default()
    r.GET("/api/health", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "status": "ok",
            "version": "1.0",
        })
    })
    r.Run(":8080") // 监听 8080 端口
}

在终端执行 go run main.go，若输出 [GIN-debug] Listening and serving HTTP on :8080，则说明环境搭建成功。此时访问 http://localhost:8080/api/health 应返回 {"status":"ok","version":"1.0"}。