MSBuild无法以真正并行方式构建多个独立库目标求助

问题背景 #

项目基于单CMakeLists.txt管理，包含多个静态库（通过add_library定义）和可执行文件（通过add_executable定义），库采用分层结构，每个库通过target_precompile_headers配置预编译头。Windows平台使用Visual Studio生成器，构建后生成对应.sln和.vcxproj文件。

当前构建情况：

• 构建单个库：正常并行，能充分利用CPU核心
• 构建带依赖的可执行文件：依赖目标自动并行构建，CPU使用率接近100%
• 构建多个独立库：通过cmake --build --target LibA;LibB;LibC;LibD调用时，目标串行执行，无法实现跨目标并行；但Visual Studio IDE中选择多个目标构建可正常并行

可行解决方案 #

方案1：直接调用MSBuild处理解决方案 #

跳过CMake的多目标传递，直接用MSBuild命令调用生成的.sln文件，指定要构建的多个目标：

msbuild ProjectName.sln /m /p:Configuration=Debug /p:Platform=x64 /p:CL_MPcount=<logicalCores> /t:LibA;LibB;LibC;LibD

• /m：启用MSBuild多进程并行构建
• /t:：指定要构建的多个目标，MSBuild会自动并行处理无依赖的目标

方案2：在CMake中创建聚合目标 #

在项目的CMakeLists.txt中添加一个虚拟的聚合目标，将所有需要并行构建的独立库设为其依赖：

# 创建无产物的自定义目标
add_custom_target(AllIndependentLibs)
# 添加需要并行构建的库作为依赖
add_dependencies(AllIndependentLibs LibA LibB LibC LibD)

之后只需构建这个聚合目标即可实现并行：

cmake --build --preset=<BuildPresetName> --parallel --target AllIndependentLibs -- /p:CL_MPcount=<logicalCores>

CMake会将聚合目标的构建请求传递给MSBuild，由MSBuild并行处理其所有依赖库。

问题根源 #

当通过cmake --build指定多个分号分隔的目标时，CMake的逻辑是逐个启动独立的MSBuild进程处理每个.vcxproj文件，而非将多个目标交给同一个MSBuild进程统筹。单个MSBuild进程仅处理一个目标，因此无法实现跨目标的并行调度，表现为串行执行。

而Visual Studio IDE或直接调用MSBuild处理.sln时，是由同一个MSBuild进程管理所有指定目标，它能识别目标间无依赖关系，从而并行分配构建任务，充分利用CPU资源。

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