1. Go 语言环境搭建：从零开始构建压测基础
Go 语言环境是 gRPC 服务压测闭环的基石。本节将带你完成从 SDK 安装、模块管理到 IDE 配置的全流程，确保后续压测脚本编写与执行环境一致、可复现。
1.1 Go SDK 安装与版本选择
推荐使用 Go 官方维护的 LTS 稳定版本（当前为 Go 1.22.x），避免使用 beta 或 rc 版本。gRPC 与 protobuf 对 Go 版本有最低要求，建议 ≥1.21。
| 操作系统 | 安装方式 | 安装路径（默认） | 验证命令 |
|---|---|---|---|
| Linux (amd64) | 下载 tar.gz 解压至 /usr/local | /usr/local/go | go version |
| macOS (Intel/Apple Silicon) | pkg 安装包 或 brew install go | /usr/local/go | go version |
| Windows | msi 安装包，勾选添加到 PATH | C:\Program Files\Go | go version |
💡 提示：安装完成后务必执行
go env 检查 GOROOT 与 GOPATH 是否正确。若使用 Apple Silicon Mac，请确认 GOARCH=arm64，避免编译出的二进制与压测环境架构不匹配。
1.2 GOPATH 与 Go Modules 配置
Go Modules 自 Go 1.11 引入，1.16 起成为默认模式。压测项目必须使用 Modules 管理依赖，确保版本锁定与可复现构建。
1.2.1 环境变量设置
# Linux / macOS（写入 ~/.bashrc 或 ~/.zshrc）
export GOPATH=$HOME/go
export GOBIN=$GOPATH/bin
export PATH=$PATH:/usr/local/go/bin:$GOBIN
# Windows（系统环境变量）
GOPATH = C:\Users\你的用户名\go
GOBIN = %GOPATH%\bin
PATH = 追加 %GOPATH%\bin1.2.2 初始化压测项目模块
mkdir grpc-loadtest && cd grpc-loadtest
go mod init github.com/yourname/grpc-loadtest
# 后续添加依赖时自动更新 go.mod / go.sum
⚠️ 避坑：不要将压测项目放在
$GOPATH/src 下。Modules 项目可以放在任意目录，但路径中不要包含中文或空格，否则 protoc 插件可能解析失败。
1.3 GoLand / VSCode 开发环境配置
两种主流 IDE 的配置要点对比如下：
| 配置项 | GoLand (JetBrains) | VSCode + Go 扩展 |
|---|---|---|
| Go SDK 路径 | File → Settings → Go → GOROOT | Ctrl+Shift+P → Go: Locate Configured Go Tools |
| Modules 代理 | Settings → Go → Go Modules → Proxy | 设置 go env -w GOPROXY=https://goproxy.cn,direct |
| 代码格式化 | 内置 gofmt，保存自动格式化 | 安装 Go 扩展后启用 formatOnSave |
| 调试 gRPC 服务 | 原生支持 Delve 调试器 | 安装 Go Delve 插件，配置 launch.json |
| Proto 文件支持 | 安装 Protocol Buffers 插件 | 安装 vscode-proto3 扩展 |
1.4 环境验证：压测闭环的第一个检查点
完成上述配置后，执行以下命令验证整个链路是否就绪：
# 1. 确认 Go 版本
go version
# 输出示例：go version go1.22.2 linux/amd64
# 2. 确认模块代理
go env GOPROXY
# 输出示例：https://goproxy.cn,direct
# 3. 确认 protoc 编译器（后续章节会用到）
protoc --version
# 输出示例：libprotoc 27.0
# 4. 确认 gRPC 相关工具链
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
which protoc-gen-go
# 输出示例：/home/user/go/bin/protoc-gen-go
📌 关键检查点：如果
protoc-gen-go 或 protoc-gen-go-grpc 不在 $GOBIN 中，后续生成 gRPC 桩代码时会报错。请确保 $GOBIN 已加入 PATH。
1.5 环境搭建全景图
下图展示了从 SDK 安装到 IDE 就绪的完整链路，以及各组件在压测闭环中的位置：
1.6 常见问题与快速排查
- go: command not found — 检查
PATH是否包含/usr/local/go/bin，重启终端或执行source ~/.bashrc。 - GOPATH 未设置 — Go 1.16+ 默认
GOPATH=$HOME/go，但显式设置更可靠。 - protoc-gen-go 版本不兼容 — 确保 protoc 版本 ≥3.21，且
protoc-gen-go与protoc-gen-go-grpc均为最新。 - IDE 无法识别 proto 文件 — 安装对应扩展后，重启 IDE 并检查文件关联设置。
🔧 快速验证脚本：将上述环境验证命令保存为
check_env.sh，每次搭建新环境时一键运行，确保压测闭环起点一致。