3. Go 开发环境搭建

在开始 gRPC-Go 开发之前，必须搭建一套完整、可复现的本地开发环境。本章将指导你完成 Go 语言安装、Go Module 初始化以及 gRPC 与 Protobuf 工具链的安装与验证。环境一致性是后续契约编写与权限验证的基础，请严格按步骤操作。

3.1 Go 安装与配置

Go 语言是 gRPC 服务端与客户端的主要实现语言。推荐使用 Go 1.21 及以上版本，以支持最新的泛型与工具链特性。

3.1.1 下载与安装

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

3.1.2 验证安装

$ go version
go version go1.22.2 linux/amd64

$ go env GOPATH
/home/youruser/go

若版本号正确且 GOPATH 指向预期目录，则 Go 安装成功。

3.2 Go Module 初始化

Go Module 是 Go 1.11 引入的官方依赖管理方案。每个 gRPC 项目都应从 go mod init 开始，确保依赖版本可追溯、可复现。

3.2.1 创建项目目录并初始化

$ mkdir grpc-auth-example
$ cd grpc-auth-example
$ go mod init github.com/yourname/grpc-auth-example
go: creating new go.mod: module github.com/yourname/grpc-auth-example

生成的 go.mod 文件内容如下：

module github.com/yourname/grpc-auth-example

go 1.22

3.2.2 添加 gRPC 依赖

使用 go get 拉取 gRPC 核心库与 Protobuf 运行时：

$ go get google.golang.org/grpc@latest
$ go get google.golang.org/protobuf@latest

执行后 go.mod 会自动更新依赖版本，并生成 go.sum 文件用于校验。

3.3 gRPC 与 Protobuf 相关工具安装

gRPC-Go 开发需要三个核心工具：protoc（协议编译器）、protoc-gen-go（Go 代码生成插件）、protoc-gen-go-grpc（gRPC 服务代码生成插件）。

3.3.1 安装 protoc

3.3.2 安装 protoc-gen-go 与 protoc-gen-go-grpc

使用 go install 安装这两个插件，它们会被编译到 $GOPATH/bin 目录：

$ go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
$ go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

验证安装：

$ protoc-gen-go --version
protoc-gen-go v1.34.1

$ protoc-gen-go-grpc --version
protoc-gen-go-grpc 1.4.0

3.4 工具链关系与工作流程

下图展示了从 .proto 契约文件到 Go 代码的完整编译链路：

3.5 验证完整工具链

创建一个最小 .proto 文件并编译，验证所有工具是否正常工作：

3.5.1 编写测试 proto 文件

// proto/hello/v1/hello.proto
syntax = "proto3";

package hello.v1;

option go_package = "github.com/yourname/grpc-auth-example/proto/hello/v1;hellov1";

message SayHelloRequest {
  string name = 1;
}

message SayHelloResponse {
  string message = 2;
}

service Greeter {
  rpc SayHello (SayHelloRequest) returns (SayHelloResponse);
}

3.5.2 执行编译

$ protoc --proto_path=proto \
  --go_out=. --go_opt=paths=source_relative \
  --go-grpc_out=. --go-grpc_opt=paths=source_relative \
  proto/hello/v1/hello.proto

3.5.3 检查生成结果

$ ls proto/hello/v1/
hello.pb.go  hello_grpc.pb.go  hello.proto

若同时生成 hello.pb.go 和 hello_grpc.pb.go，且无错误输出，则工具链安装成功。

3.6 环境清单速查

至此，Go 开发环境、Module 初始化以及 gRPC 工具链已全部就绪。下一阶段将基于此环境编写第一个带权限验证的 gRPC 服务。