Visual Studio 2022属性表PropertyGroup中使用$(OutDir)的问题

问题与原因 #

在Visual Studio 2022的C++解决方案中，直接在<CopyFileToFolders>项的DestinationFolders元数据中使用$(OutDir)的属性表可正常工作；但先在<PropertyGroup>中定义<CustomDestination>=$(OutDir)，再在DestinationFolders中引用$(CustomDestination)的属性表，修改项目输出目录时会失效。

核心原因：CustomDestination属性的求值时机早于VS IDE确定$(OutDir)的时机，而项元数据会在所有属性求值完成后再处理，导致CustomDestination提前固化为旧的$(OutDir)值，无法同步更新。

通用解决方案：转义变量表达式+动态展开 #

通过转义保存原始变量表达式，再在项元数据中用MSBuild属性函数动态展开，实现属性与项的分离，同时支持任意变量组合：

1. 属性定义属性表（如CustomDestinations.props） #

用$$转义$，将变量表达式以字符串形式保存，避免提前求值：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <!-- 保存原始变量表达式，$$会被解析为单个$，不立即展开$(OutDir) -->
    <CustomDestination>$$(OutDir)AdditionalFiles\$$(Platform)</CustomDestination>
  </PropertyGroup>
</Project>

2. 项定义属性表（如CopyFileConfig.props） #

使用MSBuild.ExpandProperties函数，在项元数据求值阶段（所有属性已完全确定）动态展开CustomDestination中的变量：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemDefinitionGroup>
    <CopyFileToFolders>
      <!-- 动态展开变量表达式，确保使用最新的$(OutDir)等值 -->
      <DestinationFolders>$([MSBuild]::ExpandProperties($(CustomDestination), $(MSBuildProjectDirectory)))</DestinationFolders>
    </CopyFileToFolders>
  </ItemDefinitionGroup>
</Project>

原理说明 #

• $$转义后，CustomDestination存储的是原始字符串$(OutDir)AdditionalFiles\$(Platform)，而非提前求值后的固定路径；
• $([MSBuild]::ExpandProperties(...))函数会在项元数据处理阶段解析字符串中的变量，此时$(OutDir)、$(Platform)等属性已根据当前项目配置确定，确保路径始终同步更新。

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