3. Go 语言环境搭建：SDK 安装、模块配置与工具推荐

在开始构建 Circuit Breaker 状态机之前，必须搭建一个稳定、可复现的 Go 开发环境。本章将指导你完成 Go SDK 的安装、从 GOPATH 到 Go Modules 的迁移，并推荐适合本课程的开发工具。一个干净的环境能避免后续压测与调试中的路径混乱问题。

3.1 Go SDK 安装与版本选择

本课程基于 Go 1.21+，该版本对泛型、错误处理与模块兼容性有更好的支持。建议从 Go 官方下载页 获取对应操作系统的安装包。

3.2 GOPATH 与 Go Modules 配置

Go 的依赖管理经历了从 GOPATH 到 Go Modules 的演进。本课程所有项目均使用 Modules 模式，避免全局路径污染。

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

在 Go 1.11 之前，所有项目必须放在 $GOPATH/src 下，且不内置版本管理。这种模式在多项目并行时容易产生依赖冲突。

3.2.2 Go Modules 模式（推荐）

从 Go 1.16 开始，Modules 成为默认模式。你可以在任意目录创建项目，通过 go.mod 文件声明依赖与版本。

# 初始化新模块
mkdir circuit-breaker-demo
cd circuit-breaker-demo
go mod init github.com/yourname/circuit-breaker-demo

# 查看 go.mod 内容
cat go.mod

# 添加依赖（自动更新 go.mod 与 go.sum）
go get github.com/stretchr/testify@v1.9.0

3.3 常用开发工具推荐

以下工具经过社区验证，能显著提升 Circuit Breaker 状态机的开发与调试效率。

3.4 环境验证与项目结构

完成安装后，通过以下步骤验证环境是否就绪，并建立本课程的标准项目骨架。

1. 验证 Go 版本与模块支持： go version 与 go env GOMOD 应返回非空路径。
2. 创建项目目录： 在 ~/projects 下新建 circuit-breaker-lab。
3. 初始化模块： go mod init circuit-breaker-lab。
4. 编写第一个测试文件： 创建 state_test.go，写入空测试函数，执行 go test ./... 确认无报错。

circuit-breaker-lab/
├── go.mod
├── go.sum
├── internal/
│   ├── state/          # 状态机核心逻辑
│   ├── metrics/        # 指标收集
│   └── config/         # 配置解析
├── cmd/
│   └── server/         # 可执行入口
├── test/
│   ├── integration/    # 集成测试
│   └── benchmark/      # 压测脚本
└── docs/               # 设计文档

3.5 常见问题与避坑指南

• 代理问题： 国内网络环境下，设置 GOPROXY=https://goproxy.cn,direct 可加速依赖下载。
• 多版本管理： 使用 go install golang.org/dl/go1.21.0@latest 可并行管理多个 Go 版本。
• IDE 插件失效： 确保 VS Code 的 go.gopath 设置与 go env GOPATH 一致，并重启 gopls。
• 权限错误： 若 go install 报权限拒绝，检查 $GOPATH/bin 是否在 PATH 中且用户可写。

#!/bin/bash
echo "Go Version: $(go version)"
echo "GOPATH: $(go env GOPATH)"
echo "GOMODCACHE: $(go env GOMODCACHE)"
echo "GO111MODULE: $(go env GO111MODULE)"
echo "GOPROXY: $(go env GOPROXY)"
echo "PATH: $PATH"