如何用gRPC进行C++微服务开发？C++ RPC框架入门教程【分布式系统】

用 gRPC 做 C++ 微服务开发，核心是定义接口、生成桩代码、实现服务端逻辑、启动客户端调用——不依赖复杂中间件，靠 Protocol Buffers + HTTP/2 就能跑通轻量高并发的跨服务通信。

定义清晰的服务契约（.proto 文件）

所有 gRPC 通信始于一个 .proto 文件，它声明服务方法、请求响应结构和数据类型。这是服务间唯一共享的“协议”，必须严格版本管理。

• 用 service 块定义 RPC 方法，支持 unary（一问一答）、server streaming、client streaming 和 bidi streaming 四种模式
• 所有字段用 explicitly numbered 字段序号（如 1, 2），避免后续兼容问题
• 推荐把公共 message（如 ErrorDetail、Timestamp）抽到独立 proto 文件中，用 import 复用
• 示例片段：
  syntax = "proto3";
  package example;
  message GetUserRequest { string user_id = 1; }
  message User { string name = 1; int32 age = 2; }
  service UserService { rpc Get(GetUserRequest) returns (User); }

生成 C++ 桩代码并链接 gRPC 库

用 protoc 工具配合 gRPC 插件生成可直接编译的 C++ 类：服务基类（供你继承实现）、客户端 stub、序列化工具。

• 安装 protoc 和 grpc_cpp_plugin（Linux/macOS 可用 apt 或 brew；Windows 推荐 vcpkg）
• 命令示例：
  protoc --cpp_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_cpp_plugin` user.proto
• 生成 user.pb.h/.cc（data class）和 user.grpc.pb.h/.cc（service stub）
• CMake 中需链接 gRPC::grpc++、gRPC::grpc++_reflection（可选，用于调试）和 protobuf::libprotobuf

编写服务端：继承基类 + 启动 Server

你只需重写 service 基类中的纯虚函数，其余网络、线程、连接复用全由 gRPC runtime 管理。

标签： linux windows 工具 mac ai c++ macos win stream 状态码 cos 微服务开发 r