2. 环境准备：Go语言版本选择、安装Go Modules、初始化项目、配置Go Proxy

在开始构建基于 OpenTelemetry 的 Go Web 慢查询追踪系统之前，我们需要搭建一个干净、可复现的 Go 开发环境。本章将指导你完成从版本选择到项目初始化的全过程，确保后续的追踪代码能够稳定运行。

2.1 Go 语言版本选择

OpenTelemetry Go SDK 对 Go 版本有明确要求。为了获得最佳的兼容性和性能，建议使用 Go 1.21 或更高版本。下表列出了不同 Go 版本对 OpenTelemetry 核心特性的支持情况：

2.2 安装 Go Modules 并初始化项目

Go Modules 是 Go 官方自 1.11 版本起引入的依赖管理工具，在 1.16 版本后成为默认行为。我们无需额外安装，只需通过 go mod init 命令即可为项目创建模块文件。

执行以下步骤初始化项目：

1. 创建项目目录：mkdir otel-go-web-tracing && cd otel-go-web-tracing
2. 初始化模块：go mod init github.com/your-username/otel-go-web-tracing
3. 验证模块文件：检查目录下是否生成了 go.mod 文件

初始化完成后，go.mod 文件内容示例如下：

module github.com/your-username/otel-go-web-tracing

go 1.21

2.3 配置 Go Proxy

由于网络环境差异，直接访问 Go 官方模块仓库（proxy.golang.org）可能不稳定。配置国内或可靠的 Go Proxy 可以显著提升依赖下载速度。以下是两种常见的配置方式：

方式一：设置环境变量（推荐）

在终端中执行以下命令，将 Go Proxy 设置为国内镜像：

go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct

该配置的含义是：优先使用 goproxy.cn，失败时回退到 goproxy.io，最后直接连接源站。

方式二：通过 ~/.bashrc 或 ~/.zshrc 永久配置

将以下行添加到你的 shell 配置文件中：

export GOPROXY=https://goproxy.cn,https://goproxy.io,direct

然后执行 source ~/.bashrc 或 source ~/.zshrc 使其生效。

2.4 项目初始化流程总览

下面的 SVG 图展示了从环境检查到项目初始化的完整流程，帮助你建立全局视角：

2.5 验证环境是否就绪

完成上述步骤后，执行以下命令验证环境是否配置正确：

# 检查 Go 版本
go version

# 查看 Go Proxy 配置
go env GOPROXY

# 查看模块文件
cat go.mod

# 尝试下载一个测试依赖（可选）
go get golang.org/x/sync@latest

如果所有命令都能正常输出且没有网络超时错误，说明你的 Go 环境已经准备就绪，可以进入下一章开始编写 OpenTelemetry 追踪代码。