如何在Github Actions中配置Protobuf解决C++项目CMake构建失败问题

方案1：在Workflow中直接安装系统包 #

这是最直接的解决方式，针对不同操作系统在Github Actions的Job步骤里添加对应安装命令即可：

Linux（Ubuntu环境） #

在Workflow的steps中加入：

- name: Install Protobuf
  run: sudo apt-get update && sudo apt-get install -y protobuf-compiler libprotobuf-dev

Windows环境 #

利用Github Actions默认自带的Chocolatey包管理器安装：

- name: Install Protobuf
  run: choco install protoc --confirm

macOS环境 #

通过Homebrew安装：

- name: Install Protobuf
  run: brew install protobuf

优点：依赖系统预编译包，构建速度快；缺点：需要针对不同平台维护对应的安装命令。

方案2：用CMake FetchContent自动拉取编译Protobuf #

如果不想在Workflow中维护多平台的安装逻辑，可以让CMake在构建阶段自动下载、编译Protobuf，实现完全跨平台的依赖管理：

修改你的CMakeLists.txt，替换原有find_package(Protobuf REQUIRED)相关代码：

include(FetchContent)

FetchContent_Declare(
  protobuf
  GIT_REPOSITORY https://github.com/protocolbuffers/protobuf.git
  GIT_TAG        v25.3  # 替换为你需要的Protobuf版本号
)

FetchContent_MakeAvailable(protobuf)

# 后续可直接使用Protobuf的官方目标链接库
# target_link_libraries(你的项目目标 PRIVATE protobuf::libprotobuf)
# include_directories(${protobuf_SOURCE_DIR}/src)

优点：无需在Workflow中添加任何额外步骤，本地开发未装Protobuf时也能自动处理；缺点：首次构建会下载并编译Protobuf，速度略慢，但后续构建会缓存编译结果。

补充：优化CMake查找逻辑（可选） #

如果仍倾向于使用系统包，也可以在CMake中指定Protobuf的查找路径，但需要配合Workflow的安装步骤使用，不如前两个方案简便：

find_package(Protobuf REQUIRED PATHS "/path/to/protobuf/install")

内容的提问来源于stack exchange，提问作者c.abate