2. 环境搭建：Go版本选择与安装、Go Module初始化、依赖管理工具（go mod tidy）使用
在开始编写《Go权限审计网关单测夹具》之前，必须搭建一个稳定、可复现的Go开发环境。本章将指导你完成Go版本选择、安装验证、Module初始化以及依赖管理工具的标准操作流程。
2.1 Go版本选择与安装
本课程基于Go 1.21+版本进行开发，原因如下：
- 内置工具链增强：Go 1.21 起，
go mod tidy行为更加严格，能自动移除未使用的依赖并记录go.sum校验和。 - 泛型稳定：单测夹具中大量使用泛型构建通用断言和Mock工厂，1.18+ 是基础，1.21+ 提供更好的类型推断。
- 安全与性能：长期支持版本（如 1.21.x、1.22.x）包含关键安全补丁和编译器优化。
| 版本 | 推荐场景 | 说明 |
|---|---|---|
| Go 1.21.x | 生产环境 / 课程主版本 | 稳定、工具链完善，推荐所有学员使用 |
| Go 1.22.x | 新项目 / 尝鲜 | 循环变量语义改进，但与本课程核心内容无关 |
| Go 1.20.x | 遗留项目兼容 | 缺少 go mod tidy -diff 等新特性，不推荐 |
安装建议：访问
https://go.dev/dl/ 下载对应操作系统的安装包。安装完成后，在终端执行 go version 验证。输出示例：go version go1.21.13 linux/amd64。
2.2 Go Module 初始化
Go Module 是官方推荐的依赖管理方案。每个项目必须有一个 go.mod 文件作为依赖清单的根声明。
初始化命令：
# 在项目根目录执行
go mod init github.com/your-org/auth-gateway-test执行后，项目根目录会生成 go.mod 文件，内容类似：
module github.com/your-org/auth-gateway-test
go 1.21命名规范：
- 使用完整的仓库路径（如
github.com/<用户>/<项目>），避免本地路径冲突。 - 如果项目仅用于本地学习，可以使用
module auth-gateway-test简化命名。 - 禁止使用
module main或module test等过于通用的名称。
2.3 依赖管理工具：go mod tidy
go mod tidy 是 Go 依赖管理的核心命令，负责同步 go.mod 与源代码的实际依赖关系。在单测夹具开发中，每次添加或删除外部包后，都必须执行此命令。
执行时机：
- 首次克隆项目后
- 添加新的第三方依赖（如
go get github.com/stretchr/testify） - 删除或替换了某个依赖的引用
- 切换 Git 分支或合并代码后
命令效果：
# 在项目根目录执行
go mod tidy
# 输出示例（无错误时无输出）
# 如果依赖有变动，会输出类似：
# go: downloading github.com/stretchr/testify v1.9.0
# go: added github.com/stretchr/testify v1.9.0| 操作 | go.mod 变化 | go.sum 变化 |
|---|---|---|
| 添加新依赖 | 新增 require 条目 | 新增对应哈希校验行 |
| 移除未使用依赖 | 删除对应 require 条目 | 删除对应哈希行 |
| 升级依赖版本 | 更新 require 中的版本号 | 更新哈希行 |
| 无变化 | 无变化 | 无变化 |
常见陷阱：
go mod tidy 会移除所有未被任何 .go 文件 import 的依赖。如果你在测试文件中使用了某个包但测试文件未被包含在构建标签中，该依赖会被误删。建议在运行 go mod tidy 前，先执行 go test ./... 确保所有测试文件可编译。
2.4 完整环境搭建步骤
以下是一个标准化的环境搭建流程，适用于本课程所有章节：
- 安装 Go 1.21+：下载安装包并验证
go version。 - 创建项目目录：
mkdir auth-gateway-test && cd auth-gateway-test - 初始化 Module：
go mod init github.com/your-org/auth-gateway-test - 编写第一个测试文件（可选）：创建
main_test.go并写入简单测试。 - 整理依赖：
go mod tidy - 验证构建：
go build ./...和go test ./...
验证命令：执行
go env GOMOD，如果输出当前项目 go.mod 的绝对路径，则说明 Module 初始化成功。
2.5 依赖管理最佳实践
- 锁定依赖版本：提交
go.mod和go.sum到版本控制，确保团队和CI环境使用完全相同的依赖版本。 - 避免直接修改 go.mod：使用
go get或go mod edit命令修改依赖，不要手动编辑文件。 - 定期执行 go mod tidy：在每次提交前运行，保持依赖清单干净。
- 使用 vendor 目录（可选）：对于离线环境或需要精确复现的场景，执行
go mod vendor将依赖复制到本地vendor目录。
2.6 验证环境
完成上述步骤后，执行以下命令确认环境就绪：
# 1. 确认 Go 版本
go version
# 2. 确认 Module 初始化
go env GOMOD
# 3. 确认无依赖问题
go mod verify
# 4. 确认项目可编译
go build ./...