Visual Studio 2022：将引用DLL移至bin子目录并抑制冗余文件生成

一、将NuGet依赖DLL移至子目录 #

可以通过修改项目配置，把Microsoft.Data.SqlClient相关的依赖DLL统一放到bin\release\dll子目录，同时保证程序运行时能正常加载这些DLL，具体有两种方法：

方法1：修改项目文件（.csproj） #

直接在项目的.csproj文件中添加以下配置代码：

<PropertyGroup>
  <!-- 指定依赖DLL的输出子目录 -->
  <DependencyOutputPath>$(OutputPath)dll\</DependencyOutputPath>
</PropertyGroup>

<Target Name="CopyDependenciesToSubfolder" AfterTargets="ResolveReferences">
  <!-- 筛选Microsoft.Data.SqlClient相关的依赖文件 -->
  <ItemGroup>
    <ReferenceCopyLocalPaths Include="@(ReferenceCopyLocalPaths)" Condition="'%(ReferenceCopyLocalPaths.NuGetPackageId)' == 'Microsoft.Data.SqlClient' or '%(ReferenceCopyLocalPaths.NuGetPackageId)' startsWith 'Microsoft.Data.SqlClient.'"/>
  </ItemGroup>
  <!-- 复制到子目录 -->
  <Copy SourceFiles="@(ReferenceCopyLocalPaths)" DestinationFolder="$(DependencyOutputPath)" SkipUnchangedFiles="true"/>
  <!-- 删除原bin目录下的对应文件 -->
  <Delete Files="@(ReferenceCopyLocalPaths)"/>
</Target>

<Target Name="AddProbingPath" BeforeTargets="GenerateProgramDatabaseFile">
  <!-- 配置程序集探测路径，让程序能找到子目录里的DLL -->
  <WriteLinesToFile File="$(OutputPath)$(AssemblyName).dll.config" Lines="<configuration><runtime><assemblyBinding xmlns='urn:schemas-microsoft-com:asm.v1'><probing privatePath='dll'/></assemblyBinding></runtime></configuration>" Overwrite="false" Encoding="utf-8"/>
</Target>

这段代码会自动把相关依赖DLL移到dll子目录，并在应用配置文件中添加探测路径，确保程序运行时能正常加载。

方法2：使用发布配置文件（.pubxml） #

如果是通过Visual Studio的发布功能部署项目，可以在发布配置文件（.pubxml）中添加以下配置：

<PropertyGroup>
  <DependenciesOutputPath>$(PublishDir)dll\</DependenciesOutputPath>
</PropertyGroup>
<Target Name="CopyDependencies" AfterTargets="Publish">
  <!-- 筛选除主程序外的所有DLL -->
  <ItemGroup>
    <DependencyFiles Include="$(PublishDir)*.dll" Condition="'%(Filename)' != '$(AssemblyName)'"/>
  </ItemGroup>
  <!-- 复制到子目录并删除原文件 -->
  <Copy SourceFiles="@(DependencyFiles)" DestinationFolder="$(DependenciesOutputPath)"/>
  <Delete Files="@(DependencyFiles)"/>
  <!-- 添加探测路径到配置文件 -->
  <WriteLinesToFile File="$(PublishDir)$(AssemblyName).dll.config" Lines="<configuration><runtime><assemblyBinding xmlns='urn:schemas-microsoft-com:asm.v1'><probing privatePath='dll'/></assemblyBinding></runtime></configuration>" Overwrite="false" Encoding="utf-8"/>
</Target>

二、关于*.xml和*.pdb文件的说明与抑制生成 #

1. 文件说明 #

• *.xml：是NuGet包附带的XML注释文档，包含类、方法的注释信息，主要用于开发时IDE显示智能提示，并非项目编译生成。
• *.pdb：是程序数据库文件，包含调试信息。Release模式下默认生成简化版pdb，用于发布后排查问题。

2. 抑制生成方法 #

（1）禁止复制*.xml文件

在.csproj文件中添加以下配置，单独排除Microsoft.Data.SqlClient包的XML文件：

<ItemGroup>
  <PackageReference Include="Microsoft.Data.SqlClient" Version="你的包版本">
    <ExcludeAssets>xml</ExcludeAssets>
  </PackageReference>
</ItemGroup>

如果要全局排除所有NuGet包的XML文件，可添加：

<PropertyGroup>
  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>
<ItemGroup>
  <Content Remove="**\*.xml" />
  <None Remove="**\*.xml" />
</ItemGroup>

（2）禁止生成*.pdb文件

• 通过UI设置：右键项目 → 属性 → 生成 → 高级 → 调试信息，选择「无」。
• 修改项目文件：在.csproj中添加以下配置，仅针对Release模式生效：

<PropertyGroup Condition="'$(Configuration)' == 'Release'">
  <DebugType>None</DebugType>
  <DebugSymbols>false</DebugSymbols>
</PropertyGroup>

注意：如果需要发布后调试问题，建议保留「pdb-only」选项，完全关闭会失去调试能力。

内容的提问来源于stack exchange，提问作者Tobias G.