C++项目CI/CD首选GitHub Actions,基于Ubuntu-latest环境显式指定编译器与C++标准,分步执行检出、编译、测试、质量检查(-Werror、ASan、头文件自包含、clang-format),再按需扩展多平台构建、打包发布与缓存加速。

为C++项目配置CI/CD,核心是让代码提交后自动编译、运行测试、检查质量,并在通过后可选地打包或发布。GitHub Actions 是目前最轻量、与 GitHub 深度集成的选择,无需额外维护服务器,适合大多数开源或中小型 C++ 项目。
选择合适的构建环境与工具链
C++ 编译高度依赖编译器版本、标准库、CMake 版本和依赖管理方式。GitHub Actions 提供 Ubuntu、Windows 和 macOS 运行器,推荐从 Ubuntu-latest 开始(稳定、社区支持好、预装较全)。
- 明确指定 C++ 标准(如
CXX_STANDARD 17)和编译器(g++-11或clang++-14),避免因默认版本变动导致构建失败 - 用
cmake --version和gcc --version在 workflow 中打印版本,便于排查兼容性问题 - 若项目用 Conan、vcpkg 或 Hunter 管理依赖,需在 CI 中显式安装并配置(例如用
conan install . --build=missing)
编写可复用的 GitHub Actions 工作流
将 workflow 文件放在 .github/workflows/ci.yml,一个典型结构包含:检出代码 → 设置编译器 → 配置 CMake → 构建 → 运行测试 → 可选静态分析。
- 使用
actions/checkout@v4获取代码,加上fetch-depth: 0支持 Git 命令(如获取 tag 或生成版本号) - 用
sudo update-alternatives或sudo apt-get install安装特定 g++/clang 版本(Ubuntu 上常见) - CMake 配置建议分步:先
cmake -B build -S . -DCMAKE_BUILD_TYPE=Debug,再cmake --build build --target all - 测试命令写成
ctest --test-dir build --output-on-failure,确保失败时显示详细日志
加入基础质量门禁(不依赖第三方服务)
不用引入复杂平台,也能在 CI 中做有效质量控制:
立即学习“C++免费学习笔记(深入)”;
-
编译警告即错误:加
-Werror到 CMake 的CMAKE_CXX_FLAGS,防止新警告被忽略 -
简单内存检查:用 AddressSanitizer 编译(
-fsanitize=address -fno-omit-frame-pointer),配合ASAN_OPTIONS=detect_leaks=1运行测试 -
头文件自包含检查:对每个
.h文件单独编译(g++ -c header.h -I. -x c++-header),验证无隐式依赖 -
格式统一:用
clang-format --dry-run -Werror检查是否符合约定,失败则阻断 PR
按需扩展:打包、跨平台、语义化发布
当项目稳定后,可以自然延伸 CI 能力:
- 用
cpack打包(DEB/RPM/TGZ),上传到 GitHub Releases(配合actions/upload-release-asset@v1) - 触发多平台构建:用
strategy.matrix同时跑 Ubuntu + Windows + macOS,不同系统用对应 CMake Generator(Ninja / Visual Studio / Xcode) - 结合
git tag自动发布:用on.push.tags触发 workflow,解析v1.2.3格式,设置PROJECT_VERSION并打 Release - 缓存构建产物(
~/.conan、build/、CMake toolchain)用actions/cache@v4加速后续运行
基本上就这些。C++ 的 CI 不复杂但容易忽略编译器细节和依赖隔离——把环境显式声明清楚,把构建步骤拆解可验证,就能稳住主线质量。不需要一步到位,从“能编过 + 跑通测试”开始,再逐步加门禁和发布能力。










