Visual Studio 2019：Content文件缺失时本地构建成功但TFS服务器构建失败，如何强制检查文件存在性？

这种本地构建“放过”缺失Content文件但服务器构建失败的情况确实很头疼——毕竟本地没报错，到了CI才出问题太耽误时间。下面给你几个靠谱的解决方案，能让本地构建就及时发现这类问题：

1. 在.csproj中添加自定义MSBuild目标（最直接有效） #

你可以通过添加一个自定义的构建前目标，强制检查所有标记为Content的文件是否存在于磁盘上。一旦发现缺失，直接终止构建并报错。

打开你的项目文件（.csproj），在<Project>标签内添加以下代码：

<Target Name="EnforceContentFilesExist" BeforeTargets="BeforeBuild">
  <!-- 收集所有Content类型的文件 -->
  <ItemGroup>
    <MissingContentFiles Include="@(Content)" Condition="!Exists('%(FullPath)')" />
  </ItemGroup>
  <!-- 如果有缺失文件，抛出错误 -->
  <Error Condition="'@(MissingContentFiles)' != ''" 
         Text="以下Content文件缺失：%0D%0A@(MissingContentFiles -> '%(FullPath)', '%0D%0A')" />
</Target>

添加后，下次本地构建时，只要.csproj里列出的Content文件在磁盘上找不到，VS就会立刻报错，和TFS服务器构建的行为保持一致。

2. 利用MSBuild的TreatMissingAsError属性 #

部分MSBuild项类型支持TreatMissingAsError属性，你可以直接给所有Content项开启这个设置，让缺失的文件触发构建错误。

在.csproj的<ItemGroup>区域（或者专门新增一个）添加：

<ItemGroup>
  <!-- 更新所有Content项，开启缺失即报错 -->
  <Content Update="@(Content)" TreatMissingAsError="true" />
</ItemGroup>

这个方法更简洁，不过要注意：这个属性的支持度可能和你使用的.NET版本有关，如果你用的是较新的.NET Core/.NET 5+，这个设置应该能正常工作；如果是传统.NET Framework项目，可能需要结合第一个方法来确保生效。

3. 启用Visual Studio的项目文件一致性检查 #

VS本身有一些设置可以加强项目文件和磁盘文件的一致性检查：

• 打开VS的工具 > 选项 > 项目和解决方案 > 常规，勾选**“检测项目文件中的缺失文件”**（不同VS版本选项位置可能略有差异）。
• 另外，你可以右键项目，选择**“卸载项目”，然后右键选择“编辑.csproj”**，修改完成后重新加载项目，有时候能触发VS重新扫描文件状态，及时发现缺失项。

为什么本地构建会成功？ #

简单说，VS本地构建可能会依赖之前的构建缓存，或者默认对缺失的Content文件采取“警告而非错误”的宽松策略；而TFS服务器构建通常是在干净的工作区执行，没有缓存，并且会严格检查所有项目中声明的文件是否存在，所以问题会暴露出来。

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