4. gRPC开发环境搭建：安装protoc编译器、安装gRPC库、Go/Python环境配置、生成桩代码

搭建gRPC开发环境是进入双向流实时通信实践的第一步。本章将引导你完成从底层工具链到上层语言运行时的全流程配置，并最终生成可调用的桩代码（Stub Code）。环境搭建的准确性直接影响后续微服务通信的稳定性，请严格按照版本对应关系操作。

4.1 环境全景概览

gRPC开发环境由四个核心层次构成，每一层都依赖前一层的正确安装。下图展示了从协议定义到服务调用的完整工具链关系：

4.2 安装 protoc 编译器

protoc 是 Protocol Buffers 的官方编译器，负责将 .proto 文件编译为各语言代码。它不依赖任何语言运行时，是环境搭建的第一步。

4.2.1 下载与安装

4.2.2 安装 protoc 插件

gRPC 代码生成需要额外的 protoc 插件。Go 生态需要两个插件，Python 则内置在 grpcio-tools 包中。

# Go 插件安装（需先配置 Go 环境）
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

# 验证插件是否在 PATH 中
which protoc-gen-go
which protoc-gen-go-grpc

4.3 安装 gRPC 核心库

gRPC 核心库提供 HTTP/2 传输、序列化、服务注册等底层能力。不同语言安装方式不同，但核心 API 语义一致。

4.3.1 Go 环境配置

# 初始化 Go 模块
mkdir grpc-demo && cd grpc-demo
go mod init grpc-demo

# 安装 gRPC 核心库
go get google.golang.org/grpc@v1.60.0

# 安装 protobuf 运行时
go get google.golang.org/protobuf@latest

4.3.2 Python 环境配置

# 创建虚拟环境（推荐）
python3 -m venv grpc-env
source grpc-env/bin/activate  # Linux/macOS
# grpc-env\Scripts\activate   # Windows

# 安装 gRPC 核心库与工具
pip install grpcio==1.60.0
pip install grpcio-tools==1.60.0

# 验证安装
python -c "import grpc; print(grpc.__version__)"

4.4 编写 .proto 文件并生成桩代码

桩代码（Stub Code）是 gRPC 通信的桥梁，包含客户端调用接口和服务端骨架。我们以一个支持双向流的实时聊天服务为例，演示完整生成流程。

4.4.1 定义 .proto 文件

// chat.proto
syntax = "proto3";

package chat;

option go_package = "grpc-demo/chatpb";

// 聊天消息结构
message ChatMessage {
  string user_id = 1;
  string content = 2;
  int64 timestamp = 3;
}

// 聊天服务定义
service ChatService {
  // 双向流 RPC：客户端与服务端持续交换消息
  rpc ChatStream(stream ChatMessage) returns (stream ChatMessage);
}

4.4.2 生成 Go 桩代码

# 创建输出目录
mkdir -p chatpb

# 执行代码生成
protoc --go_out=. \
       --go-grpc_out=. \
       --go_opt=paths=source_relative \
       --go-grpc_opt=paths=source_relative \
       chat.proto

# 生成的文件结构
# chatpb/
#   chat.pb.go          # 消息序列化代码
#   chat_grpc.pb.go     # gRPC 服务端/客户端桩代码

4.4.3 生成 Python 桩代码

# 使用 grpcio-tools 提供的 protoc 封装
python -m grpc_tools.protoc \
       -I. \
       --python_out=. \
       --grpc_python_out=. \
       chat.proto

# 生成的文件结构
# chat_pb2.py           # 消息序列化代码
# chat_pb2_grpc.py      # gRPC 服务端/客户端桩代码

4.5 桩代码结构解析

生成的桩代码包含三个核心部分，理解其结构有助于后续微服务开发：

4.6 环境验证清单

完成上述步骤后，使用以下清单快速验证环境是否就绪：

1. protoc 编译器：protoc --version 输出 v3.21.0 或更高
2. Go 插件：which protoc-gen-go 和 which protoc-gen-go-grpc 返回有效路径
3. Go gRPC 库：go list -m google.golang.org/grpc 显示 v1.60.0
4. Python gRPC 库：python -c "import grpc; print(grpc.__version__)" 输出 1.60.0
5. 桩代码生成：检查 chatpb/ 目录下是否存在 chat.pb.go 和 chat_grpc.pb.go（Go）或 chat_pb2.py 和 chat_pb2_grpc.py（Python）