使用vcpkg安装protobuf后遇版本不兼容编译错误求助

问题原因 #

你遇到的编译错误是因为生成代码的protoc版本（3.16.0）与项目依赖的protobuf库版本（3.21.4）不匹配。Protobuf强制要求：用于生成C++代码的protoc工具版本，必须和链接的protobuf库版本完全一致，否则会触发版本校验的编译报错。

解决方案 #

1. 定位vcpkg安装的对应版本protoc #

vcpkg安装的protobuf配套工具（包括protoc）默认存放在以下路径：

<你的vcpkg安装目录>\vcpkg_installed\x64-windows\tools\protobuf

该目录下的protoc.exe就是与你安装的3.21.4版本库匹配的工具。

2. 使用匹配版本的protoc重新生成代码 #

打开命令行，切换到test.proto所在目录，执行以下命令（替换路径为实际的vcpkg安装路径）：

"C:\your_vcpkg_path\vcpkg_installed\x64-windows\tools\protobuf\protoc.exe" test.proto --cpp_out=.

3. 更新项目中的生成文件 #

删除之前用3.16.0版本protoc生成的test.pb.h和test.pb.cc，将新生成的文件添加到项目中。

4. 重新编译项目 #

完成上述步骤后重新编译，版本不兼容的编译错误即可解决。

额外提示 #

• 开发过程中务必保证protoc工具版本与protobuf库版本完全一致，避免混用不同版本引发冲突。
• 可将vcpkg的protobuf工具目录加入系统PATH环境变量，后续直接使用protoc命令即可调用匹配版本的工具，无需每次输入完整路径。

内容的提问来源于stack exchange，提问作者Dark Sorrow