gRPC开发指南：Visual Studio 2022 + Vcpkg + Windows全流程配置
前言
gRPC作为Google开源的高性能RPC框架，在微服务架构中扮演着重要角色。本文将详细介绍在Windows平台下，使用Visual Studio 2022和Vcpkg进行gRPC开发的完整流程，包括环境配置、项目搭建、常见问题解决等实用内容。
环境准备
1. 安装必要组件
首先确保已安装以下软件：
-
Visual Studio 2022（需勾选"C++桌面开发"工作负载）
-
Git（用于Vcpkg管理）
2. 配置Vcpkg（具体可以参考这个C ++第三方库安装工具）
# 克隆Vcpkg仓库
git clone https://github.com/microsoft/vcpkg.git
cd vcpkg# 安装Vcpkg
.\bootstrap-vcpkg.bat# 集成到全局（需要管理员权限）
.\vcpkg integrate install二、安装gRPC依赖
在vcpkg的根目录下打开cmd
# 安装gRPC和Protobuf
vcpkg install grpc:x64-windows protobuf:x64-windows# 可选：安装测试工具
vcpkg install grpc:x64-windows protobuf:x64-windows gtest:x64-windows
三、使用 protoc 编译 .proto 文件
1.在任意位置新建文件夹，并新建.proto 文件，如HelloWorld.proto，并编辑文件类容。
syntax = "proto3";
package HelloWorld;
service Greeter{rpc SayHello (HelloRequest) returns (HelloReply){
}
}message HelloRequest {string name = 1;
}message HelloReply{string message =1;}
2.在相应的当前目录下打开cmd，编译此 .proto 文件（生成 .pb.h 和 .pb.cc）
protoc --proto_path=你的proto文件目录 --cpp_out=输出目录 HelloWorld.proto比如我的位置
protoc --proto_path=. --cpp_out=. HelloWorld.protoprotoc --proto_path=. --grpc_out=. --plugin=protoc-gen-grpc="E:\Vcpkg\vcpkg\installed\x64-windows\tools\grpc\grpc_cpp_plugin.exe" HelloWorld.proto 
2.1如果protoc -- 编译失败，可能是编译路径不对，可以将protoc 编译环境变量配置到全局变量中。
3.再编译完成之后，会在你的测试文件夹下生成相应的编译文件
三、在vs2022中创建客户端与服务端项目进行测试
设置项目结构如下，服务端和客户端工程目录结构一样。
（1）客户端代码如下
#include <grpcpp/grpcpp.h>#include "../HelloWorld.pb.h" // 确保路径正确
#include "../HelloWorld.grpc.pb.h"using grpc::Channel;
using grpc::ClientContext;
using grpc::Status;
using HelloWorld::HelloRequest;
using HelloWorld::HelloReply;
using HelloWorld::Greeter;class GreeterClient {
public:GreeterClient(std::shared_ptr<Channel> channel): stub_(Greeter::NewStub(channel)) {}std::string SayHello(const std::string& name) {HelloRequest request;request.set_name(name);HelloReply reply;ClientContext context;// 发起RPC调用Status status = stub_->SayHello(&context, request, &reply);if (status.ok()) {return reply.message();}else {std::cerr << "RPC failed: " << status.error_message() << std::endl;return "RPC Error";}}private:std::unique_ptr<Greeter::Stub> stub_;
};int main() {// 连接到服务端（地址需与服务端一致）std::string server_address("localhost:50059");GreeterClient client(grpc::CreateChannel(server_address,grpc::InsecureChannelCredentials() // 测试用非安全连接));// 发起请求std::string name("World");std::string response = client.SayHello(name);std::cout << "Server responded: " << response << std::endl;return 0;
}（2）服务端代码如下
HelloWorldService.h
#pragma once
#include <grpcpp/grpcpp.h>
#include "../HelloWorld.pb.h"
#include "../HelloWorld.grpc.pb.h"using grpc::Server;
using grpc::ServerBuilder;
using grpc::ServerContext;
using grpc::Status;
using HelloWorld::HelloRequest;
using HelloWorld::HelloReply;
using HelloWorld::Greeter;// 添加RunServer函数声明
void RunServer(); //class GreeterServiceImpl final : public Greeter::Service {
public:Status SayHello(ServerContext* context,const HelloRequest* request,HelloReply* reply) override;
};HelloWorldService.cpp
#include "HelloWorldService.h"Status GreeterServiceImpl::SayHello(ServerContext* context,const HelloRequest* request,HelloReply* reply) {std::string prefix("Hello ");reply->set_message(prefix + request->name());return Status::OK;
}void RunServer() {std::string server_address("0.0.0.0:50059");GreeterServiceImpl service;ServerBuilder builder;builder.AddListeningPort(server_address, grpc::InsecureServerCredentials());builder.RegisterService(&service);std::unique_ptr<Server> server(builder.BuildAndStart());std::cout << "Server listening on " << server_address << std::endl;server->Wait();
}main.cpp
// 只包含头文件，不要包含.cpp文件！
#include "HelloWorldService.h" int main() {RunServer();return 0;
}同时启动项目，结果如下。
