C++项目CI/CD流水线核心是cmake + ctest两条命令锚定流程：cmake -S . -B build完成可复现配置，cmake --build构建，ctest --test-dir build执行测试；90%问题源于配置阶段失败，而非构建或测试本身。
直接说结论：C++项目的自动化构建与测试，在 CI/CD 流水线里不是靠“写一堆脚本拼凑”，而是靠 cmake + ctest 这两个命令锚定整个流程。只要项目结构规范、CMakeLists.txt 正确，CI 脚本可以压缩到 5 行以内；出问题时，90% 的根源在配置阶段（cmake）没过，而不是构建或测试本身失败。
为什么必须用 cmake -S . -B build 而不是直接 cd build && cmake ..
这是 CI 环境中最容易被忽略的细节。旧写法 cd build && cmake .. 依赖当前工作目录状态，而 CI runner（尤其是 GitLab Runner 的 shell executor）常会复用工作目录、残留上一次构建缓存，导致 CMakeCache.txt 错误继承旧配置，比如编译器路径、CMAKE_BUILD_TYPE 混乱，最终出现“本地能编译、CI 报 undefined reference”这类问题。
新写法 cmake -S . -B build 显式声明源码目录和构建目录，强制 CMake 做 clean start，不读取任何隐式缓存。GitLab CI / GitHub Actions 的容器环境每次都是干净的，但 shell executor 不一定——所以统一用 -S/-B 是最省心的兜底方案。
- 所有现代 CMake 版本（≥3.13）都支持
-S/-B，不用降级兼容 - 如果项目仍用旧版 CMake（如 3.10），至少加
rm -rf build && mkdir build清理前缀 - 不要在
build/下再建子目录（如build/release），这会让ctest --test-dir找不到测试
ctest --test-dir build 总是找不到测试？检查这三个地方
ctest 不是自动扫描源码里的 TEST 宏，它只认 CMake 在配置阶段注册进 CTestTestfile.cmake 的测试项。常见“找不到测试”根本不是 ctest 问题，而是 CMake 配置漏了关键步骤：
立即学习“C++免费学习笔记（深入）”；
- 确保
add_executable(tests ...)后紧跟add_test(NAME mytest COMMAND tests)，或者用include(CTest)+enable_testing()开启测试发现（仅对部分框架有效） - Google Test 项目必须链接
gtest_main或自己实现main()，否则生成的可执行文件无法被 ctest 调用 -
ctest --test-dir build中的build必须是运行cmake时指定的-B目录，且该目录下存在CTestTestfile.cmake（生成于配置阶段）
快速验证：在 CI 脚本里加一行 ls -l build/CTestTestfile.cmake，不存在就说明 cmake 阶段压根没注册测试。
GitHub Actions 和 GitLab CI 的关键参数差异
两者底层都跑 Linux 容器，但默认行为不同，直接影响 C++ 构建稳定性：
- GitHub Actions 默认使用
ubuntu-latest（目前是 22.04），GCC 版本为 11.4，CMake 为 3.22 —— 若项目依赖 GCC 12+ 的 C++20 特性，需显式指定runs-on: ubuntu-24.04 - GitLab CI 的
image必须明确指定基础镜像，例如image: gcc:12；若用debian:stable这类通用镜像，GCC/CMake 版本不可控，大概率触发 “CMakeLists.txt 要求 CXX_STANDARD 20，但编译器不支持” 错误 - 二者都建议禁用
ccache缓存（除非你手动配置共享缓存服务），CI 环境本就是 clean build，开 ccache 反而因哈希冲突导致增量编译错误
示例最小可行 CI 片段（GitHub Actions）：
jobs:
build-test:
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v4
- run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=g++-11
- run: cmake --build build -j$(nproc)
- run: ctest --test-dir build --output-on-failure测试失败但不报错？别让 ctest 静默吞掉 exit code
CI 流水线判断任务成败，只看命令返回值。而 ctest 默认行为是：哪怕 10 个测试里 9 个失败，只要命令本身执行成功（无 segfault、无 I/O error），就返回 0 —— 导致流水线显示“✅ passed”，实际功能全挂。
必须加 --return-timeout 300（防死锁）和 --output-on-failure（暴露失败详情），更重要的是：在 CI 脚本里显式检查 ctest 返回值：
- GitHub Actions：
ctest --test-dir build || exit 1——||是必须的，否则失败被忽略 - GitLab CI：
ctest --test-dir build后加if [ $? -ne 0 ]; then exit 1; fi，因为 shell executor 不自动传播非零退出码 - 若用 Google Test 生成 JUnit XML，记得加
--junit-output test-results.xml，否则后续覆盖率或报告工具读不到结果
真正难调试的从来不是编译失败，而是测试通过率 87% 却没人发现——因为 CI 没把失败当失败。
