MSBuild构建链如何单次构建实现依赖项目文件拷贝至输出目录

需要运行两次MSBuild才能拿到完整输出的核心原因有两点：

• 通用PostProcessBuild目标没有绑定到标准构建流程的正确节点，也没有声明对项目引用解析步骤的依赖。构建B时，虽然MSBuild会优先编译被引用的A，但A的拷贝动作没有被纳入项目构建完成的判定链路，导致B启动自己的拷贝逻辑时，A还没把文件拷到自身的输出目录。
• B当前错误地直接引用A的源码目录作为拷贝源，完全绕过了A的构建输出流程，再加上目标执行时序错乱，第一次构建时自然拿不到A生成到输出目录的文件。

1. 调整通用PostProcessBuild目标的执行逻辑 #

给目标补上构建流程挂载点和依赖项，保证执行顺序正确：

<Target Name="PostProcessBuild" 
    AfterTargets="Build"
    DependsOnTargets="ResolveProjectReferences"
    Inputs="@(ProjectOutput)"
    Outputs="@(ProjectOutput->'%(Destination)%(FileName)%(Extension)')">
    <Message Text="Post-Processing Build for $(MSBuildProjectName)" />
    <Copy 
        SourceFiles="@(ProjectOutput)" 
        DestinationFolder="%(ProjectOutput.Destination)" 
        SkipUnchangedFiles="true"/>
</Target>

改动说明：

• 加AfterTargets="Build"，让目标在项目核心构建动作完成后自动触发，不需要手动调用
• 加DependsOnTargets="ResolveProjectReferences"，保证执行拷贝前，所有被引用的项目已经跑完包括自身PostProcessBuild在内的全部构建流程
• 拷贝任务加SkipUnchangedFiles="true"，优化增量构建速度，避免重复拷贝无变更的文件

2. 简化项目A的输出配置 #

原配置里两个Include规则会重复匹配根目录文件，合并为一条递归规则即可：

<Project Sdk="Microsoft.Build.NoTargets" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectOutput Include="$(MSBuildProjectDirectory)\pySpark\**\*" Destination="$(OutDir)\%(RecursiveDir)"/>
    </ItemGroup>
</Project>

这里直接用**\*递归匹配pySpark目录下的所有文件和子目录，自动保留原有目录结构，同时去掉了Destination路径里多余的反斜杠，避免路径拼接异常。

3. 修正项目B的拷贝源配置 #

不要直接引用A的源码目录，改为引用A构建完成后的输出目录，避免绕过A的构建流程：

<Project Sdk="Microsoft.Build.NoTargets" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">     
    <ItemGroup>
        <ProjectReference Include="$(INETROOT)\sources\dev\Projects\xplat\A\A.xpproj">
            <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
            <SkipGetTargetFrameworkProperties>true</SkipGetTargetFrameworkProperties>
        </ProjectReference>
        <!-- 包含B自身的业务文件，按实际路径调整即可 -->
        <ProjectOutput Include="$(MSBuildProjectDirectory)\**\*.py" Destination="$(OutDir)\%(RecursiveDir)"/>
        <!-- 引用A构建完成后的输出目录下的所有文件 -->
        <ProjectOutput Include="$(AOutputDir)\**\*" Destination="$(OutDir)\%(RecursiveDir)"/>
    </ItemGroup>

    <Target Name="GetReferencedProjectProps" AfterTargets="ResolveProjectReferences">
        <PropertyGroup>
            <!-- 按实际目录结构配置A项目的输出目录路径 -->
            <AOutputDir>$(AllProjectsRoot)\A\$(OutDir)</AOutputDir>
        </PropertyGroup>
    </Target>
</Project>

改完之后只需要运行一次MSBuild，执行顺序会自动变成：构建A -> 执行A的PostProcessBuild把py文件拷到A的OutDir -> 构建B -> 执行B的PostProcessBuild，同时把B自身的文件和A OutDir里已经生成好的文件拷到B的OutDir，不需要二次构建。

补充说明：如果你的构建配置里自定义了OutDir的重定向规则，只需要调整AOutputDir的取值，保证它指向A项目构建完成后的实际输出路径即可。

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