2. Go语言环境搭建：Go SDK安装与配置、GOPATH与Go Modules、常用IDE配置（VS Code/GoLand）、第一个Go Web服务

本章是《Go Web契约压测》课程的实践起点。你将完成Go SDK的安装、环境变量配置、依赖管理机制的理解、IDE调试环境的搭建，并最终运行起第一个Go Web服务。所有后续的REST API契约测试与压测脚本，都将基于本章搭建的环境运行。

2.1 Go SDK安装与配置

2.1.1 下载与安装

访问Go官方下载页面（https://go.dev/dl/），根据操作系统选择对应的安装包：

2.1.2 环境变量验证

安装完成后，打开终端（Windows 使用 PowerShell 或 CMD），执行以下命令验证安装：

go version
# 输出示例：go version go1.21.5 darwin/arm64

go env GOROOT
# 输出示例：/usr/local/go

go env GOPATH
# 输出示例：/Users/yourname/go

如果 go version 提示命令未找到，请检查 PATH 环境变量是否包含 GOROOT/bin 目录。

2.2 GOPATH 与 Go Modules 机制

Go 的依赖管理经历了从 GOPATH 到 Go Modules 的演进。理解两者的区别，是避免后续项目结构混乱的关键。

2.2.1 Go Modules 核心命令

• go mod init <module-name> — 初始化新模块，生成 go.mod 文件。
• go mod tidy — 添加缺失的依赖，移除未使用的依赖，更新 go.sum。
• go mod download — 下载 go.mod 中声明的所有依赖到本地缓存。
• go mod vendor — 将依赖复制到项目根目录的 vendor 文件夹（用于离线构建）。

2.3 常用IDE配置

本课程推荐两种主流开发环境：VS Code + Go扩展（轻量、免费）和 GoLand（功能全面、商业授权）。

2.3.1 VS Code 配置步骤

1. 安装 VS Code，打开扩展面板（Ctrl+Shift+X）。
2. 搜索并安装 Go 扩展（由 Go Team at Google 提供）。
3. 安装完成后，按 Ctrl+Shift+P 打开命令面板，输入 Go: Install/Update Tools，全选所有工具并点击确定。这会自动安装 gopls（语言服务器）、dlv（调试器）、staticcheck（静态分析）等核心工具。
4. 打开任意 Go 项目，VS Code 会自动识别 go.mod 并启用 Modules 模式。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch Web Server",
            "type": "go",
            "request": "launch",
            "mode": "auto",
            "program": "${workspaceFolder}/main.go",
            "env": {},
            "args": []
        }
    ]
}

2.3.2 GoLand 配置要点

• GoLand 开箱即支持 Go Modules，只需在 Settings → Go → Go Modules 中勾选 Enable Go Modules integration。
• 调试器默认使用 dlv，直接在代码行号旁点击即可添加断点，点击右上角 Debug 按钮启动。
• 建议安装 Key Promoter X 插件（非必须），帮助快速掌握快捷键。

2.4 第一个Go Web服务

下面我们创建一个最简单的 HTTP 服务，验证整个环境链路是否通畅。该服务将监听 8080 端口，并返回一条 JSON 响应。

2.4.1 项目初始化

mkdir go-web-practice
cd go-web-practice
go mod init go-web-practice

此时项目目录下会生成 go.mod 文件，内容类似：

module go-web-practice

go 1.21

2.4.2 编写主程序

创建 main.go 文件，写入以下代码：

package main

import (
    "encoding/json"
    "log"
    "net/http"
)

// HealthResponse 定义健康检查接口的响应结构
type HealthResponse struct {
    Status  string `json:"status"`
    Message string `json:"message"`
}

func healthHandler(w http.ResponseWriter, r *http.Request) {
    // 仅允许 GET 方法
    if r.Method != http.MethodGet {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }

    resp := HealthResponse{
        Status:  "ok",
        Message: "Go Web 服务运行正常",
    }

    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)
    json.NewEncoder(w).Encode(resp)
}

func main() {
    http.HandleFunc("/health", healthHandler)

    log.Println("服务启动于 http://localhost:8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

2.4.3 运行与验证

在终端执行：

go run main.go

打开另一个终端，使用 curl 测试：

curl -i http://localhost:8080/health

预期输出：

HTTP/1.1 200 OK
Content-Type: application/json
Date: Mon, 01 Jan 2024 00:00:00 GMT
Content-Length: 49

{"status":"ok","message":"Go Web 服务运行正常"}

2.5 本章知识结构图

下图展示了从环境搭建到第一个 Web 服务的完整链路，以及各组件之间的依赖关系：

2.6 常见问题排查