如何在变量定义中引用ItemGroup的Identity？MSBuild配置问题

问题原因 #

你遇到的路径为空错误，核心原因是目标外部的ItemGroup在元数据计算阶段，%(Identity)可能未被解析为有效绝对路径，或者MSBuild在项目加载阶段处理元数据时，文件路径的上下文环境不正确，导致File::ReadAllText无法找到指定文件。另外，直接在ItemGroup元数据中执行文件读取操作，还可能带来文件锁定、内容不实时更新的问题。

解决方案 #

推荐将文件读取、内容替换和保存的逻辑放到目标内部执行，利用目标执行时的项元数据（如%(FullPath)）确保路径绝对且有效，同时满足Inputs参数的需求。

方案1：使用MSBuild内置属性和任务处理 #

<!-- 外部ItemGroup，满足Inputs参数需求 -->
<ItemGroup>
  <PRSetting Include="$(settings_root)\settings_config_*.xml" />
</ItemGroup>

<Target Name="PrepSettings" Inputs="@(PRSetting)" Outputs="@(PRSetting->'%(FullPath)')">
  <!-- 遍历每个匹配的文件 -->
  <PropertyGroup>
    <!-- 获取文件绝对路径 -->
    <CurrentFilePath>%(PRSetting.FullPath)</CurrentFilePath>
    <!-- 读取文件内容 -->
    <OriginalContent>$([System.IO.File]::ReadAllText('$(CurrentFilePath)'))</OriginalContent>
    <!-- 替换版本标记 -->
    <UpdatedContent>$([System.String]::Copy('$(OriginalContent)').Replace('[config.version]', '$(PR_Version)'))</UpdatedContent>
  </PropertyGroup>
  
  <!-- 将修改后的内容写回原文件 -->
  <WriteLinesToFile 
    File="$(CurrentFilePath)" 
    Lines="$(UpdatedContent)" 
    Overwrite="true" 
    Encoding="UTF-8" />
</Target>

方案2：用PowerShell命令简化替换 #

如果觉得C#方法调用繁琐，也可以通过Exec任务调用PowerShell完成替换，避免路径解析问题：

<ItemGroup>
  <PRSetting Include="$(settings_root)\settings_config_*.xml" />
</ItemGroup>

<Target Name="PrepSettings" Inputs="@(PRSetting)">
  <Exec 
    Command="powershell -Command &quot;(Get-Content '%(PRSetting.FullPath)') -replace '\[config.version\]', '$(PR_Version)' | Set-Content '%(PRSetting.FullPath)'&quot;"
    WorkingDirectory="$(MSBuildProjectDirectory)" />
</Target>

关键细节说明 #

1. 使用%(FullPath)：相比%(Identity)，%(FullPath)会返回文件的绝对路径，彻底避免相对路径导致的找不到文件问题。
2. 目标内部分离逻辑：将文件操作放到目标内部，确保在构建执行阶段才处理文件，既保证路径有效，也能应对文件在构建过程中被修改的场景。
3. Inputs/Outputs配置：方案1中Outputs设置为原文件路径，MSBuild会自动检查文件是否已更新，避免重复执行。

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