用 C++ 做 gRPC 微服务，核心是三步：写 .proto 定义接口、用 protoc 生成 C++ 代码、在服务端/客户端中调用生成的类和方法。不复杂，但容易卡在环境配置和生命周期管理上。
1. 环境准备与依赖安装
确保系统已安装：
- Protobuf 编译器（protoc ≥ 3.20），建议从 GitHub 官方发布页 下载预编译二进制，避免源码编译踩坑
- gRPC C++ 库（含 libgrpc, libgrpc++），推荐用 cmake + fetchcontent 在项目内拉取，避免系统级安装版本冲突
- CMake ≥ 3.16，支持
find_package(gRPC CONFIG)
不建议用 apt/yum 直接装 grpc-dev —— Ubuntu 的包常滞后且缺 C++ 插件支持。
2. 编写 .proto 文件并生成代码
例如定义一个简单用户服务：
立即学习“C++免费学习笔记（深入）”；
// user_service.proto syntax = "proto3"; package example;service UserService { rpc GetUser (UserRequest) returns (UserResponse); }
message UserRequest { int32 id = 1; }
message UserResponse { int32 id = 1; string name = 2; bool exists = 3; }
执行生成命令（需确保 protoc 能找到 gRPC 插件）：
protoc -I . --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_cpp_plugin` user_service.proto protoc -I . --cpp_out=. user_service.proto
会生成 user_service.pb.h/.cc 和 user_service.grpc.pb.h/.cc。注意：两个 .h 文件都要 include，否则编译报错。
3. 实现服务端（同步方式）
继承自生成的 UserService::Service 类，重写 RPC 方法：
class UserServiceImpl final : public example::UserService::Service {
public:
Status GetUser(ServerContext* context, const UserRequest* request,
UserResponse* response) override {
if (request->id() == 123) {
response->set_id(123);
response->set_name("Alice");
response->set_exists(true);
} else {
response->set_exists(false);
}
return Status::OK;
}
};启动服务器时注意：
- 用
ServerBuilder添加监听地址（如"0.0.0.0:50051"） - 注册服务实例（
builder.RegisterService(&service)） - 调用
builder.BuildAndStart()后，服务即运行 —— 不需要手动 run() 循环 - 记得保存返回的
std::unique_ptr，它控制生命周期；析构即关闭服务
4. 编写客户端调用
创建 Channel 和 Stub，再发起调用：
auto channel = grpc::CreateChannel("localhost:50051", grpc::InsecureChannelCredentials());
auto stub = example::UserService::NewStub(channel);
ClientContext context;
UserRequest req;
req.set_id(123);
UserResponse resp;
Status status = stub->GetUser(&context, req, &resp);
if (status.ok()) {
std::cout << "Name: " << resp.name() << "\n";
} else {
std::cerr << "RPC failed: " << status.error_message() << "\n";
}
关键点：
- Channel 是线程安全的，可复用；Stub 不是，但通常每个线程一个或共享也没问题
-
InsecureChannelCredentials()仅用于开发；生产务必用ssl_credentials并配置根证书 - 同步调用会阻塞当前线程；如需异步，用
AsyncUnaryCall+CompletionQueue，但复杂度明显上升
整个流程跑通后，就可以加日志、健康检查（gRPC 自带 /healthz）、服务发现（配合 Consul/Etcd）、熔断（用 client-side interceptor 封装）了。C++ gRPC 性能高、控制强，适合对延迟和资源敏感的微服务场景。
