4. Go 开发环境准备：工具链与编译器安装

在开始编写 gRPC 服务之前，必须搭建一套完整、可复用的 Go 开发环境。本章将依次完成 Go 语言安装、Go Module 配置、protoc 编译器安装以及 protoc-gen-go 与 protoc-gen-go-grpc 插件安装四个核心步骤。每个步骤都直接影响后续的接口契约编译与代码生成，请严格按顺序操作。

4.1 Go 语言安装

Go 语言是 gRPC 服务端与客户端的主要实现语言。推荐安装 Go 1.21 及以上版本，以支持最新的泛型、工具链与 gRPC 包依赖。

4.2 Go Module 配置

Go Module 是官方推荐的依赖管理方案，从 Go 1.16 起默认启用。配置核心是设置 GOPROXY 和 GO111MODULE 两个环境变量，确保依赖下载快速且稳定。

# 开启模块模式（默认已开启）
go env -w GO111MODULE=on

# 设置国内代理（推荐使用官方镜像或七牛云）
go env -w GOPROXY=https://goproxy.io,direct

# 验证配置
go env GOPROXY GO111MODULE

4.3 protoc 编译器安装

protoc 是 Protocol Buffers 的官方编译器，负责将 .proto 文件编译为各语言代码。gRPC 依赖 protoc 来解析服务定义和消息结构。

1. 下载对应平台的压缩包：前往 protobuf releases 页面，选择 protoc-<version>-<os>-<arch>.zip。
2. 解压并放置可执行文件：将压缩包内的 bin/protoc 复制到 /usr/local/bin/（Linux/macOS）或 C:\Windows\System32\（Windows）。
3. 验证安装：执行 protoc --version，输出应类似 libprotoc 25.3。

4.4 protoc-gen-go 与 protoc-gen-go-grpc 插件安装

这两个插件是 protoc 与 Go 之间的桥梁：protoc-gen-go 生成消息类型的 Go 结构体，protoc-gen-go-grpc 生成 gRPC 服务端与客户端的接口代码。从 gRPC-Go v1.3.0 起，两个插件已分离，必须分别安装。

# 安装 protoc-gen-go（生成 .pb.go 文件）
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest

# 安装 protoc-gen-go-grpc（生成 _grpc.pb.go 文件）
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

# 验证安装（确保 $GOPATH/bin 在 PATH 中）
protoc-gen-go --version
protoc-gen-go-grpc --version

4.5 环境验证与整体架构

完成上述安装后，整个工具链的调用关系如下图所示。protoc 作为核心编译器，调用两个 Go 插件生成最终的 Go 代码文件。

4.6 常见问题与排查