MsBuild动态添加ProjectReference仅清理后生效问题求助

自定义了一个在BeforeBuild阶段触发的Target，用于在构建/重建操作前添加目标项目的ProjectReference，但该操作仅在先清理项目后再构建时才能生效。修改引用的项目后直接构建，不会生成对应的Core.dll文件，必须先清理项目才行，请问这是什么原因？

提供的配置文件内容如下：

backendconfig.targets 文件 #

<?xml version="1.0" encoding="utf-8" ?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="AddCoreBackendConfig" AfterTargets="SetCoreBackendConfig">
        <ItemGroup>
            <ProjectReference Include="..\ChoiceProject.Core\ChoiceProject.Core.csproj">
                <Project>{590E7363-8CD9-4AFA-1111-D70ECE33DE7D}</Project>
                <Name>ChoiceProject.Core</Name>
            </ProjectReference>
        </ItemGroup>
    </Target>
</Project>

项目Csproj文件相关片段 #

<None Include="Properties\backendconfig.targets" />

<Target Name="BeforeBuild">
    <CallTarget Targets="Assemble" />
    <CallTarget Targets="SetCoreBackendConfig" />
    <CallTarget Targets="AddCoreBackendConfig" />
</Target>

核心原因 #

• MSBuild的增量构建机制在起作用：MSBuild启动后会先完成项目依赖分析，计算输入输出文件的时间戳，判断哪些部分需要重新构建。你在BeforeBuild阶段才添加ProjectReference，此时依赖分析已经结束，MSBuild不会把新增的ChoiceProject.Core项目纳入本次构建的依赖链，自然不会触发它的编译。
• 只有清理项目后，所有输出文件被删除，MSBuild会重新执行完整的依赖分析，这时新增的引用才会被识别，从而触发Core项目的构建和当前项目的重新编译。

可行解决方案 #

1. 提前添加引用时机：不要在BeforeBuild阶段动态添加引用，而是把ProjectReference的添加逻辑放到项目初始化阶段。比如直接在Csproj的<ItemGroup>中静态声明，或者在InitialTargets指定的Target中添加。这样MSBuild一开始就能识别到这个依赖，增量构建时会自动检查Core项目的变化。

2. 显式触发依赖项目构建：如果必须在BeforeBuild阶段动态添加引用，可以在AddCoreBackendConfig Target中手动调用Core项目的构建目标，确保它先于当前项目编译。修改后的Target示例：

   <Target Name="AddCoreBackendConfig" AfterTargets="SetCoreBackendConfig">
       <ItemGroup>
           <ProjectReference Include="..\ChoiceProject.Core\ChoiceProject.Core.csproj">
               <Project>{590E7363-8CD9-4AFA-1111-D70ECE33DE7D}</Project>
               <Name>ChoiceProject.Core</Name>
           </ProjectReference>
       </ItemGroup>
       <!-- 强制构建Core项目 -->
       <MSBuild Projects="..\ChoiceProject.Core\ChoiceProject.Core.csproj" Targets="Build" />
   </Target>
   

3. 禁用增量构建（临时方案）：构建时使用/t:Rebuild命令代替普通构建，或者添加/p:BuildProjectReferences=true参数，强制MSBuild检查所有项目引用的状态。但这种方法会降低构建效率，不推荐长期使用。

内容的提问来源于stack exchange，提问作者Mateusz Białas