MSBuild配置公共输出目录时NuGet依赖复制问题求助

我完全懂你这种两难的处境——开UseCommonOutputDirectory=true就丢了NuGet引用，不开又要面对并行构建时的文件复制冲突。下面是几个经过实际项目验证的解决方案，你可以根据自己的项目规模和需求来选：

方案1：调整MSBuild属性补全NuGet复制逻辑 #

你可以在项目文件（.csproj）或者根目录的Directory.Build.props里添加这些配置，让NuGet依赖乖乖复制到公共输出目录：

<PropertyGroup>
  <!-- 启用公共输出目录 -->
  <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
  <!-- 自定义公共输出路径，比如根目录下统一的bin文件夹 -->
  <CommonOutputPath>$(SolutionDir)bin\$(Configuration)\$(PlatformTarget)\</CommonOutputPath>
  <!-- 强制将锁定文件里的NuGet程序集复制到输出目录 -->
  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
  <!-- 禁用并行复制，避免多任务写同文件的冲突 -->
  <DisableCopyParallelism>true</DisableCopyParallelism>
</PropertyGroup>

这里的CopyLocalLockFileAssemblies是核心，它会强制触发NuGet依赖的复制逻辑，刚好补上UseCommonOutputDirectory开启时缺失的复制步骤。

方案2：利用NuGet中央缓存跳过复制操作 #

既然冲突是因为多个任务同时复制同一个文件，那干脆跳过复制，让项目直接引用NuGet的中央缓存文件：

1. 保持UseCommonOutputDirectory=true的设置
2. 在项目配置里添加：

<PropertyGroup>
  <!-- 启用锁定文件确保依赖版本一致 -->
  <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
  <!-- 禁止本地复制，直接引用中央缓存里的程序集 -->
  <DisableCopyLocal>true</DisableCopyLocal>
</PropertyGroup>

这种方式完全省掉了复制步骤，既省磁盘空间又不会有冲突，但如果你的部署需要把依赖和程序打包在一起，得额外加个收集缓存文件的步骤。

方案3：自定义MSBuild目标处理冲突复制 #

如果上面的方案都不贴合你的场景，你可以写个自定义的MSBuild目标，在构建完成后统一处理NuGet依赖的复制，还能加重试逻辑解决冲突：

<Target Name="CopyNuGetDependenciesToCommonOutput" AfterTargets="Build">
  <ItemGroup>
    <!-- 筛选出还没复制到公共目录的NuGet程序集 -->
    <NuGetAssemblies Include="$(LockFileDependenciesPath)**\*.dll" Exclude="$(CommonOutputPath)**" />
  </ItemGroup>
  <!-- 带重试的复制任务，解决并行构建的文件冲突 -->
  <Copy 
    SourceFiles="@(NuGetAssemblies)" 
    DestinationFolder="$(CommonOutputPath)" 
    SkipUnchangedFiles="true" 
    Retries="3" 
    RetryDelayMilliseconds="1000" />
</Target>

这个目标会在每个项目构建完成后，把缺失的NuGet依赖复制到公共目录，重试机制能有效解决并行任务的文件占用冲突。

额外小提示 #

• 如果你用的是.NET 6及以上版本，可以试试配合PublishSingleFile或者PublishTrimmed功能，它们对公共输出目录的依赖处理更完善。
• 调整配置前记得清理旧的输出目录，避免残留的旧文件干扰新构建结果。

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