如何在MSBuild构建输出中重命名Content或None类型的文件？

针对构建时重命名Content文件输出名称的需求，有两种实用方法，适配不同的MSBuild项目格式：

方法1：新格式项目（.NET Core 3.0+/NET 5+） #

直接在项目文件（.csproj）的Content元素中添加TargetPath元数据，指定输出的文件名：

<Content Include="LICENSE">
  <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  <TargetPath>Foo.License.txt</TargetPath>
</Content>

这个元数据会告诉MSBuild将文件复制到输出目录时使用指定名称，同时保留CopyToOutputDirectory的逻辑（仅当文件更新时复制）。

方法2：旧格式项目（.NET Framework） #

对于传统.NET Framework项目，可通过自定义MSBuild任务实现重命名复制：

1. 先在项目文件中定义要处理的文件：

<ItemGroup>
  <LicenseFile Include="LICENSE" />
</ItemGroup>

2. 添加一个构建完成后执行的复制任务：

<Target Name="CopyLicenseWithRename" AfterTargets="AfterBuild">
  <Copy SourceFiles="@(LicenseFile)" DestinationFiles="$(OutputPath)Foo.License.txt" SkipUnchangedFiles="true" />
</Target>

SkipUnchangedFiles="true"确保仅当源文件修改时才重新复制，避免不必要的构建操作。

补充说明 #

IntelliSense未提示该属性是因为TargetPath属于MSBuild的高级元数据，不在默认提示列表中，但它是官方支持的标准属性，可直接在项目文件中手动编写。

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