2. Go 语言开发环境搭建：SDK 安装、模块管理与 IDE 配置

搭建一个稳定、可复现的 Go 开发环境是构建任务调度平台的第一步。本章将依次完成 Go SDK 的安装与验证、工作区模式从 GOPATH 到 Go Modules 的演进、以及主流 IDE（VS Code / GoLand）的调试配置，确保你后续能高效编写和调试 OpenAPI 服务代码。

2.1 Go SDK 安装与验证

Go 官方提供跨平台二进制安装包，支持 Linux、macOS 和 Windows。以下以 Go 1.22 为例（建议生产环境使用 1.21+ 以完整支持泛型与 Workspace 模式）。

2.2 GOPATH 与 Go Modules：工作区模式演进

Go 的工作区管理经历了两个主要阶段。理解其差异有助于你正确组织任务调度平台的代码仓库。

初始化 Go Modules 项目

# 创建项目目录
mkdir task-scheduler && cd task-scheduler

# 初始化模块，模块名建议使用仓库路径
go mod init github.com/yourname/task-scheduler

# 查看生成的 go.mod 文件
cat go.mod
// 输出示例：
// module github.com/yourname/task-scheduler
// go 1.22

# 添加依赖（以 gin 为例）
go get github.com/gin-gonic/gin

# 查看依赖树
go mod graph

2.3 Go Modules 依赖管理流程

下图展示了从初始化到构建的完整依赖解析路径，帮助你理解 go.mod、go.sum 和模块缓存之间的关系。

2.4 常用 IDE 配置与调试

本课程推荐使用 VS Code（轻量、插件生态丰富）或 GoLand（JetBrains 全家桶、开箱即用）。以下分别给出关键配置。

2.4.1 VS Code 配置

1. 安装 Go 扩展：搜索 “Go” 由 Go Team at Google 发布的扩展（gopls 语言服务器）。
2. 开启 Modules 支持：扩展默认已启用，无需手动设置 GO111MODULE=on。
3. 配置调试器：安装 Delve 调试后端。

# 安装 Delve
go install github.com/go-delve/delve/cmd/dlv@latest

# 验证安装
dlv version

在 VS Code 中创建 .vscode/launch.json 配置文件：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Task Scheduler API",
      "type": "go",
      "request": "launch",
      "mode": "debug",
      "program": "${workspaceFolder}/cmd/server",
      "env": {
        "PORT": "8080",
        "DB_DSN": "postgres://user:pass@localhost:5432/tasks"
      },
      "args": [],
      "showLog": true
    }
  ]
}

2.4.2 GoLand 配置

2.5 环境验证清单

完成上述配置后，执行以下命令进行全链路验证：

# 1. 确认 Go 版本
go version

# 2. 确认环境变量
go env GOPATH GOROOT GOMODCACHE GOPROXY

# 3. 创建一个临时模块并运行
mkdir /tmp/hello && cd /tmp/hello
go mod init hello
cat > main.go << 'EOF'
package main

import "fmt"

func main() {
    fmt.Println("Go 环境搭建成功！")
}
EOF
go run main.go

# 4. 验证 Delve 调试器
dlv version

2.6 本章小结

• Go SDK 安装后务必验证 go version 和 go env，确保 PATH 正确。
• 新项目统一使用 Go Modules（go mod init），不再依赖 GOPATH 目录约束。
• VS Code 用户需安装 Go 扩展和 Delve；GoLand 用户只需配置 SDK 和 Modules 代理。
• 调试配置中注意 program 指向 main 包目录，env 字段注入数据库连接等敏感配置。