Visual Studio 2022/dotnet build：无项目引用时构建复制依赖项的方法

针对你的需求——仅让Web API可见服务接口，同时自动构建依赖项目并复制其DLL到输出目录，以下是几种可行方案，按推荐优先级排序：

最优方案：MSBuild原生ProjectReference配置（隐藏实现，自动复制） #

这个方案不需要手动写复制脚本，完全依赖MSBuild的原生能力，既能保证构建顺序，又能隐藏实现类的可见性，同时自动处理DLL复制（包括依赖的依赖）。

操作步骤 #

在Web API项目的.csproj文件中手动添加以下配置：

<!-- 显式引用接口项目，Web API可正常访问接口类型 -->
<ProjectReference Include="..\YourInterfaceProject\YourInterfaceProject.csproj" />

<!-- 引用实现项目，但通过PrivateAssets隐藏对Web API的可见性 -->
<ProjectReference Include="..\DependencyA\DependencyA.csproj">
  <PrivateAssets>All</PrivateAssets>
  <ExcludeAssets>None</ExcludeAssets>
</ProjectReference>
<ProjectReference Include="..\DependencyB\DependencyB.csproj">
  <PrivateAssets>All</PrivateAssets>
  <ExcludeAssets>None</ExcludeAssets>
</ProjectReference>

核心原理 #

• PrivateAssets="All"：标记该项目引用的所有资产（代码、DLL等）仅用于当前项目，不会被暴露给Web API项目的其他依赖，Web API无法直接引用DependencyA/B中的实现类。
• ExcludeAssets="None"：确保MSBuild会复制该项目的输出DLL到Web API的输出目录。
• 构建时，MSBuild会自动按依赖顺序构建DependencyA/B和Web API，无需额外配置解决方案级依赖。

支持情况 #

• Visual Studio 2022 F5运行：完全支持，启动时会自动构建所有依赖项并复制DLL。
• dotnet build命令：直接执行dotnet build YourSolution.sln即可生效，TeamCity中无需额外脚本。

备选方案：解决方案级依赖+生成后复制脚本 #

如果不想修改.csproj，可以用这个传统方案：

步骤1：配置解决方案级构建依赖 #

在Visual Studio中：

1. 右键Web API项目 → 选择「项目依赖项」
2. 在「项目」标签页勾选DependencyA和DependencyB，确保构建时先编译这两个项目。

步骤2：添加生成后复制命令 #

在Web API项目的属性 → 生成事件 → 后期生成事件命令行中添加复制命令：

:: 替换为你的项目框架版本和路径
xcopy "$(SolutionDir)DependencyA\bin\$(Configuration)\net6.0\DependencyA.dll" "$(TargetDir)" /Y /R
xcopy "$(SolutionDir)DependencyB\bin\$(Configuration)\net6.0\DependencyB.dll" "$(TargetDir)" /Y /R

如果是跨平台环境，改用PowerShell脚本更可靠：
创建CopyDependencies.ps1脚本放在Web API项目根目录：

$sourceDirA = Join-Path $PSScriptRoot "..\DependencyA\bin\$env:Configuration\net6.0"
$sourceDirB = Join-Path $PSScriptRoot "..\DependencyB\bin\$env:Configuration\net6.0"
$targetDir = Join-Path $PSScriptRoot "bin\$env:Configuration\net6.0"

Copy-Item (Join-Path $sourceDirA "DependencyA.dll") $targetDir -Force
Copy-Item (Join-Path $sourceDirB "DependencyB.dll") $targetDir -Force

然后在后期生成事件中调用：

powershell -ExecutionPolicy Bypass -File "$(ProjectDir)CopyDependencies.ps1"

支持情况 #

• Visual Studio 2022 F5运行：配置后F5会自动构建依赖并执行复制。
• dotnet build命令：执行dotnet build YourSolution.sln时会自动触发生成后事件，无需额外操作。

批量管理方案：Directory.Build.props全局配置 #

如果多个项目有类似需求，可在解决方案根目录创建Directory.Build.props文件，统一配置依赖规则：

<Project>
  <ItemGroup>
    <!-- 仅对Web API项目生效的依赖配置 -->
    <ProjectReference Include="..\DependencyA\DependencyA.csproj" Condition="'$(MSBuildProjectName)' == 'YourWebApiProject'">
      <PrivateAssets>All</PrivateAssets>
      <ExcludeAssets>None</ExcludeAssets>
    </ProjectReference>
    <ProjectReference Include="..\DependencyB\DependencyB.csproj" Condition="'$(MSBuildProjectName)' == 'YourWebApiProject'">
      <PrivateAssets>All</PrivateAssets>
      <ExcludeAssets>None</ExcludeAssets>
    </ProjectReference>
  </ItemGroup>
</Project>

这种方式无需逐个修改项目的.csproj，便于统一维护。

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