ASP.NET Blazor项目中MSBuild忽略CopyToPublishDirectory="Always"问题

问题现象 #

ASP.NET Blazor项目默认会按照特定模式发布文件（如wwwroot/**、**/*.razor.js），通过CopyToPublishDirectory可以抑制指定文件的发布，CopyToOutputDirectory则用于控制输出目录的文件行为，本地文件夹发布时功能正常。但在发布到Azure应用的.zip包中，即使配置以下代码强制包含文件：

<ItemGroup>
  <Content Include="TextFile.xml" CopyToPublishDirectory="Always"/>
</ItemGroup>

目标文件仍未被包含到发布包内。

诊断结果 #

开启Visual Studio专业版诊断日志后发现：

• MSBuild初始阶段确实识别到了CopyToPublishDirectory="Always"的设置
• 由于目标文件匹配了wwwroot/**的默认发布模式，该设置被拒绝
• 在后续的PrepareForBuild阶段，CopyToPublishDirectory属性被移除，最终文件未被加入发布包

解决方法 #

方法1：移除默认规则后重新配置 #

先移除目标文件的默认Content包含规则，再重新添加并明确指定发布属性，避免默认模式覆盖设置：

<ItemGroup>
  <Content Remove="TextFile.xml" />
  <Content Include="TextFile.xml" CopyToPublishDirectory="Always" />
</ItemGroup>

方法2：改用None项类型绕过默认处理 #

如果目标文件位于wwwroot目录下，可将文件的项类型改为None，跳过Blazor对wwwroot下Content类型文件的默认发布逻辑：

<ItemGroup>
  <None Include="TextFile.xml" CopyToPublishDirectory="Always" />
</ItemGroup>

方法3：检查自定义MSBuild目标 #

若项目中存在自定义MSBuild目标或扩展任务，需确认是否有逻辑在修改CopyToPublishDirectory属性，确保该属性在发布流程的最终阶段未被重置。

内容的提问来源于stack exchange，提问作者MrD at KookerellaLtd