如何在CMake项目中阻止并行构建以避免竞争条件？

最优方案：修复依赖关系（推荐） #

你的问题根源是测试目标testTest和头文件生成目标GeneratedHeader之间没有明确的依赖关系，导致CMake在并行构建时可能同时执行两者，引发竞争。修复依赖后，即使并行构建也能正常工作，无需禁止并行。

具体步骤： #

1. 在src/PerformanceTestGenerator/CMakeLists.txt末尾添加代码，将生成目标暴露给父目录：

# 让上层CMakeLists能引用这个生成头文件的目标
set(GeneratedHeader_TARGET GeneratedHeader PARENT_SCOPE)

2. 在src/tests/CMakeLists.txt中，给testTest添加依赖，确保头文件生成完成后再编译测试：

# 强制testTest在GeneratedHeader完成后再构建
add_dependencies(testTest ${GeneratedHeader_TARGET})

这样CMake会自动处理构建顺序，并行构建时也不会出现头文件未生成的问题，同时保留并行构建的效率优势。

备选方案：强制禁止并行构建 #

如果确实需要禁止并行构建（不推荐，会降低构建速度），可以通过以下两种方式实现：

方式1：默认设置单线程构建 #

在顶层CMakeLists.txt中添加代码，强制默认并行级别为1：

# 强制默认单线程构建，用户手动指定-j/--parallel会覆盖此设置
set(CMAKE_BUILD_PARALLEL_LEVEL 1)

注意：用户如果手动传入-j或--parallel参数，依然会覆盖这个值，无法完全禁止。

方式2：检测并行参数并报错 #

在顶层CMakeLists.txt中添加代码，若检测到用户使用并行参数则直接终止构建：

# 检查是否使用了并行构建参数，禁止并行构建
foreach(arg IN LISTS CMAKE_ARGV)
    if(arg STREQUAL "-j" OR arg MATCHES "^-j[0-9]+$" OR arg STREQUAL "--parallel" OR arg MATCHES "^--parallel=[0-9]+$")
        message(FATAL_ERROR "并行构建已禁用：生成性能测试头文件与测试构建存在竞争条件，请移除-j/--parallel参数后重新构建。")
    endif()
endforeach()

这个方法会完全阻止用户使用并行构建参数，强制单线程构建。

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