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;
}

同时启动项目，结果如下。