CMake生成VS C++项目时如何保留VS宏配置输出与中间目录

CMake默认针对MSVC生成器的硬编码逻辑是：所有输出目录、中间目录属性在写入vcxproj文件前，会自动将非绝对路径的字符串拼接为基于构建根目录的硬编码绝对路径。核心原因是CMake不支持将纯宏字符串识别为合法的输出路径，要绕开这个展开逻辑，不能直接修改CMake自身管理的路径变量，而是通过引入独立的MSBuild属性表（props文件）的方式，原样写入原生宏字符串——因为CMake不会对外部导入的props文件内容做任何路径展开，会原样保留你写的所有宏定义，完全和手动在VS属性页中配置的效果一致。

针对三个核心问题的具体解答 #

1. 如何让CMake直接输出原生VS宏字符串，而非硬编码绝对路径 #

不要直接给CMake的RUNTIME_OUTPUT_DIRECTORY/ARCHIVE_OUTPUT_DIRECTORY/LIBRARY_OUTPUT_DIRECTORY/CMAKE_*_OUTPUT_DIRECTORY系列变量赋值宏字符串——这类变量在赋值时会被CMake强制展开为绝对路径。
正确操作方式：

• 在项目中创建独立的自定义属性表文件，比如msvc_custom_output.props，在文件中直接写入需要的OutDir、IntDir宏配置：

  <?xml version="1.0" encoding="utf-8"?>
  <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <PropertyGroup Label="UserMacros">
      <!-- 兼容老版本VS的宏兜底 -->
      <PlatformArchitecture Condition=" '$(PlatformArchitecture)' == '' ">
        $([System.String]::Copy('$(Platform)').Replace('Win32','x86').Replace('x64','x64'))
      </PlatformArchitecture>
    </PropertyGroup>
    <!-- 覆盖所有配置/平台的输出、中间目录 -->
    <PropertyGroup>
      <OutDir>$(Configuration)-$(PlatformArchitecture)\</OutDir>
      <IntDir>$(Configuration)-$(PlatformArchitecture)\$(ProjectName)\</IntDir>
    </PropertyGroup>
  </Project>
  

• 给所有MSVC目标设置VS_PROJECT_IMPORT属性，将上述属性表导入到生成的vcxproj文件中。
• 注意：在导入自定义props文件的同时，需要将CMake自身管理的所有输出目录、中间目录变量设置为空字符串，避免CMake在vcxproj中写入硬编码的路径节点覆盖props的配置。由于CMake不会解析props文件内的内容，所有宏字符串都会被原样保留到项目属性中，不会被展开为硬编码绝对路径。

2. 批量应用到所有目标的实现环节 #

完全不需要修改CMake内置的项目模板文件，也不需要逐个在每个目标的CMakeLists.txt中单独配置，有两种可落地的全局配置方式：

• 方式一：在顶层CMakeLists.txt的所有目标定义完成后（即所有add_subdirectory/add_executable/add_library调用执行完毕后），遍历CMAKE_TARGETS列表，给每个目标统一设置VS_PROJECT_IMPORT属性，可自动覆盖静态库、动态库、可执行文件等所有类型的构建目标。
• 方式二：将上述批量配置逻辑写成独立的CMake模块文件，通过命令行参数-DCMAKE_PROJECT_INCLUDE=<模块文件路径>传入配置，不需要修改原有的业务CMakeLists.txt代码，即可全局生效，且优先级高于CMakeLists.txt中定义的所有内部路径值。

3. 统一配置时需要注意的兼容陷阱 #

• 宏版本兼容问题：$(PlatformArchitecture)是VS2019 16.0及以上版本才内置的MSBuild宏，如果开发环境存在VS2017及更老版本，该宏会被解析为空，导致路径拼接错误。需要在props文件中增加宏兜底逻辑，手动将Win32这类老平台名映射为x86。
• CMake构建依赖路径错位问题：VS生成器会默认按照它自己计算的绝对路径，存储编译过程中的依赖追踪信息（比如.obj文件路径、头文件依赖规则）。如果直接通过props覆盖IntDir值，会导致编译时生成的文件路径和CMake预期的依赖路径不匹配，触发每次全量重新构建。解决方法是在配置props导入属性时，同步将CMake自身管理的中间目录路径，通过生成器表达式$<CONFIG>匹配和props中宏定义对应的实际路径，让两边计算的输出路径完全一致。
• 路径格式问题：MSBuild解析OutDir、IntDir时，如果路径结尾没有带反斜杠，会自动和输出文件名做无分隔符的字符串拼接，导致生成的目标文件路径错误（比如输出文件会被写到Debug-x64MyApp.exe而非Debug-x64/MyApp.exe）。所有自定义路径值必须保证结尾带有反斜杠。
• 平台名映射问题：VS在x86配置下的内置$(Platform)值为Win32而非x86，如果用$(Platform)拼接路径，会导致x86平台的输出目录为Debug-Win32/，和预期的Debug-x86/不一致，必须使用兼容性更好的$(PlatformArchitecture)宏。
• 导入优先级问题：props文件的导入位置必须在vcxproj文件的尾部属性段，才能覆盖CMake默认写入的硬编码路径值；如果导入位置靠前，会被后续的默认属性值覆盖，达不到预期效果。

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