引入NETStandard.Library依赖时System.*组件引用冲突问题求助

我之前在管理大型.NET Framework解决方案时也踩过这个版本冲突的坑，尤其是引入.NET Standard依赖后，NETStandard.Library带进来的System.*包和框架内置版本打架，导致烦人的FileLoadException。给你几个不用逐个项目手动修改的便捷方案：

方案1：用Directory.Build.props统一强制引用NuGet版本的System.*包 #

在解决方案的根目录创建一个Directory.Build.props文件，所有项目会自动继承这个文件的配置，这样就能一次性让所有项目统一引用NuGet包中的System.*组件，替代.NET Framework内置版本。

示例配置如下：

<Project>
  <PropertyGroup>
    <!-- 确保所有项目优先使用NuGet包，而不是框架内置程序集 -->
    <RestoreProjectStyle>PackageReference</RestoreProjectStyle>
  </PropertyGroup>

  <ItemGroup>
    <!-- 列出所有冲突的System.*包，统一指定版本（替换成你实际需要的版本） -->
    <PackageReference Include="System.Net.Http" Version="4.3.4" />
    <PackageReference Include="System.Collections" Version="4.3.0" />
    <PackageReference Include="System.ComponentModel.Annotations" Version="4.5.0" />
    <PackageReference Include="System.Console" Version="4.3.0" />
    <PackageReference Include="System.Globalization" Version="4.3.0" />
    <PackageReference Include="System.IO" Version="4.3.0" />
    <PackageReference Include="System.Linq" Version="4.3.0" />
    <PackageReference Include="System.Net.Primitives" Version="4.3.0" />
    <PackageReference Include="System.ObjectModel" Version="4.3.0" />
    <PackageReference Include="System.Reflection" Version="4.3.0" />
    <PackageReference Include="System.Resources.ResourceManager" Version="4.3.0" />
    <PackageReference Include="System.Runtime" Version="4.3.0" />
    <PackageReference Include="System.Text.Encoding" Version="4.3.0" />
    <PackageReference Include="System.Threading" Version="4.3.0" />
    <PackageReference Include="System.Xml.XmlSerializer" Version="4.3.0" />
    <!-- 可以根据你排查出的冲突包继续添加 -->
  </ItemGroup>
</Project>

把这个文件放到解决方案根目录后，重新还原NuGet包（dotnet restore或者VS里右键解决方案→还原NuGet包），所有项目就会自动引用这些指定版本的NuGet包，不再使用框架内置的组件。

方案2：启用NuGet集中包管理（Central Package Management） #

如果你的团队使用NuGet 6.0及以上版本，推荐用这个更现代的方式，它能更清晰地集中管理所有包的版本，避免版本不一致。

1. 在解决方案根目录创建Directory.Packages.props文件：

<Project>
  <PropertyGroup>
    <!-- 启用集中包管理 -->
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>

  <ItemGroup>
    <!-- 集中定义所有冲突包的版本 -->
    <PackageVersion Include="System.Net.Http" Version="4.3.4" />
    <PackageVersion Include="System.Collections" Version="4.3.0" />
    <!-- 其他冲突包版本依次添加 -->
  </ItemGroup>
</Project>

2. 然后在Directory.Build.props里添加统一的包引用：

<Project>
  <ItemGroup>
    <!-- 只需要引用包名，版本由Directory.Packages.props控制 -->
    <PackageReference Include="System.Net.Http" />
    <PackageReference Include="System.Collections" />
    <!-- 其他冲突包依次添加 -->
  </ItemGroup>
</Project>

这种方式的好处是后续要调整版本时，只需要修改Directory.Packages.props一个文件，所有项目自动同步。

方案3：补充使用程序集绑定重定向（可选） #

如果上面的方案还存在个别运行时冲突，可以配合程序集绑定重定向来兜底。你可以让Visual Studio自动生成重定向，或者在Directory.Build.targets里配置自动生成：

在解决方案根目录创建Directory.Build.targets文件：

<Project>
  <PropertyGroup>
    <!-- 自动生成绑定重定向 -->
    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
  </PropertyGroup>
</Project>

这样每个项目在编译时会自动生成适合的绑定重定向，确保运行时加载正确的版本。

验证方案有效性 #

修改完成后，你可以通过以下方式确认所有项目都统一引用了NuGet的包：

• 在Visual Studio中，右键项目→管理NuGet包，查看已安装的System.*包版本是否统一
• 使用命令行dotnet list <项目路径> package查看项目的包引用
• 用ILDasm打开项目输出的程序集，查看引用的System.*组件版本是否和NuGet包一致

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