2. Go 语言环境准备：SDK 安装、模块配置与 IDE 调试

搭建一个稳定、可复现的 Go 开发环境是进行业务回放与权限验证开发的基础。本章将指导你完成 Go SDK 的安装、从传统 GOPATH 到现代 Go Modules 的配置迁移，以及 VS Code 和 GoLand 两大主流 IDE 的调试环境搭建。

2.1 Go SDK 安装与版本选择

Go 语言官方维护两个主要版本线：稳定版（如 go1.21.x）和旧版（如 go1.18.x）。对于业务回放与权限验证项目，建议使用 Go 1.21 及以上版本，以获得更好的泛型支持、errors.Join 和 log/slog 等标准库增强。

2.2 GOPATH 与 Go Modules 配置

Go 的包管理经历了从 GOPATH 到 Go Modules 的演进。在业务回放与权限验证项目中，我们全面采用 Go Modules 模式。

2.2.1 GOPATH 模式（传统）

• 工作区结构： $GOPATH/src、$GOPATH/pkg、$GOPATH/bin
• 依赖管理： 依赖必须放在 $GOPATH/src 下，版本控制困难
• 适用场景： 仅用于维护老旧项目，新项目不再推荐

2.2.2 Go Modules 模式（现代）

• 初始化： go mod init <module-path>
• 依赖记录： go.mod + go.sum 文件
• 版本锁定： 精确记录每个依赖的版本和哈希
• 适用场景： 所有新项目，包括本课程的业务回放系统

# 设置 Go Modules 为默认模式
go env -w GO111MODULE=on

# 设置 GOPROXY 为国内镜像（加速下载）
go env -w GOPROXY=https://goproxy.cn,direct

# 设置 GOBIN（可选，用于存放编译后的二进制）
go env -w GOBIN=$HOME/go/bin

以下 SVG 展示了从 GOPATH 到 Go Modules 的演进路径与核心差异：

2.3 常用 IDE 调试环境搭建

业务回放与权限验证项目涉及复杂的请求链路和权限校验逻辑，一个配置完善的 IDE 调试环境能大幅提升开发效率。以下分别介绍 VS Code 和 GoLand 的配置要点。

2.3.1 VS Code 配置

1. 安装 Go 扩展： 搜索并安装官方 Go 扩展（由 Go 团队维护）。
2. 配置 settings.json：

{
  "go.gopath": "",
  "go.goroot": "/usr/local/go",
  "go.useLanguageServer": true,
  "go.languageServerFlags": ["-rpc.trace"],
  "go.toolsManagement.autoUpdate": true,
  "go.delveConfig": {
    "debugAdapter": "dlv-dap",
    "apiVersion": 2
  }
}

3. 安装调试工具： 按 Ctrl+Shift+P，运行 Go: Install/Update Tools，勾选 dlv、gopls、staticcheck 等核心工具。
4. 启动调试： 在 main.go 中设置断点，按 F5 启动调试。

2.3.2 GoLand 配置

1. 打开项目： 直接打开包含 go.mod 的目录，GoLand 自动识别为 Go Modules 项目。
2. 配置 SDK： File → Settings → Go → GOROOT，选择已安装的 Go SDK 路径。
3. 调试配置： 点击右上角 Add Configuration → Go Build，设置 Run kind: Directory，选择包含 main 包的目录。
4. 启动调试： 设置断点后点击 Debug 按钮（绿色甲虫图标）。

以下 SVG 展示了 VS Code 与 GoLand 调试环境的核心组件对比：

2.4 环境验证清单

完成上述配置后，执行以下命令验证环境是否就绪：

# 1. 验证 Go 版本
go version
# 输出示例：go version go1.21.5 linux/amd64

# 2. 验证 Go Modules 模式
go env GO111MODULE
# 输出应为：on

# 3. 验证代理配置
go env GOPROXY
# 输出示例：https://goproxy.cn,direct

# 4. 创建一个测试项目
mkdir -p ~/test-go-env && cd ~/test-go-env
go mod init test-env
echo 'package main; import "fmt"; func main() { fmt.Println("Go env OK") }' > main.go
go run main.go
# 输出应为：Go env OK

# 5. 验证调试器
dlv version
# 输出示例：Delve Debugger Version: 1.21.0