这确实是新旧项目格式迁移阶段非常头疼的常见问题——MSBuild会因为项目间核心构建属性（比如输出路径、目标框架）的差异，误把同一个逻辑项目识别成不同的构建目标，重复触发构建操作，最终导致文件被占用锁死。下面几个实战方案可以帮你强制MSBuild只构建目标项目一次：

1. 统一解决方案级的核心构建属性 #

MSBuild判断是否需要重新构建的关键依据之一是项目的核心属性是否一致。你可以在解决方案根目录创建Directory.Build.props文件，统一配置所有项目（无论新旧）的核心构建参数，消除属性差异带来的重复构建触发：

<Project>
  <PropertyGroup>
    <!-- 统一所有项目的输出目录，避免不同格式项目默认输出路径不同 -->
    <OutputPath>$(SolutionDir)bin\$(Configuration)\$(Platform)\</OutputPath>
    <!-- 为.NET Framework旧项目统一目标框架版本（根据你的实际版本调整） -->
    <TargetFramework Condition=" '$(TargetFramework)' == '' AND '$(ProjectTypeGuids)' != '' ">net48</TargetFramework>
    <!-- 禁用快速最新状态检测，减少MSBuild误判需要重新构建的情况 -->
    <DisableFastUpToDateCheck>true</DisableFastUpToDateCheck>
    <!-- 统一生成输出的文件名（避免旧项目可能的命名差异） -->
    <AssemblyName>$(MSBuildProjectName)</AssemblyName>
  </PropertyGroup>
</Project>

所有项目会自动继承这个文件的配置，从根源上减少MSBuild识别“不同构建目标”的可能性。

2. 使用MSBuild的-noRecompute命令行参数 #

这个参数会强制MSBuild使用第一次计算的依赖关系图，不再重新计算项目的构建状态，从而避免因为属性变化触发重复构建。适合在CI/CD流水线或者你明确知道项目依赖不会临时变化的场景使用：

msbuild YourSolution.sln /t:Build /p:Configuration=Release /noRecompute

注意：本地开发时如果修改了项目配置（比如调整目标框架），需要先去掉这个参数重新构建一次，确保依赖关系更新。

3. 排除重复构建的项目或调整构建触发规则 #

如果某些旧项目被错误地当成独立构建目标重复触发，你可以：

• GUI操作：在Visual Studio的解决方案资源管理器中，右键目标旧项目 → 属性 → 生成，取消勾选“在解决方案构建时生成”。然后确保所有依赖该项目的新项目都通过<ProjectReference>明确引用，这样MSBuild只会在新项目需要时构建它一次。
• 命令行操作：用/exclude参数直接排除不需要重复构建的项目：

msbuild YourSolution.sln /t:Build /p:Configuration=Release /exclude:OldProjectA.csproj;OldProjectB.csproj

4. 统一项目间的引用方式 #

旧csproj常用的<Reference>（直接引用dll）和新csproj的<ProjectReference>（引用项目文件）会导致MSBuild无法正确追踪依赖关系，进而触发重复构建。把所有项目间的dll引用替换成项目引用：

将旧项目中的dll引用：

<Reference Include="MySharedProject">
  <HintPath>..\MySharedProject\bin\Release\MySharedProject.dll</HintPath>
</Reference>

替换为项目引用（新旧csproj都支持这种格式）：

<ProjectReference Include="..\MySharedProject\MySharedProject.csproj" />

这样MSBuild能准确识别依赖链，避免重复构建同一个项目。

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