如何在构建中结合使用System.ValueTuple最新版与System.Text.Json

核心逻辑：版本兼容的底层机制 #

• .NET Framework 4.8自带的System.ValueTuple是框架原生组件，并非普通NuGet包。那些旧版的System.ValueTuple NuGet包，本质是微软为低版本.NET Framework（如4.6及以下）适配ValueTuple的过渡包。当程序在4.8环境运行时，CLR会自动优先加载系统自带的高版本组件，不会使用输出目录里的旧版DLL。
• 旧版过渡包的代码都是转发调用到框架原生版本的，API签名完全对齐，不存在方法不兼容的问题——微软在设计这类过渡包时，已经提前解决了兼容性问题。

实际验证与风险规避 #

• 构建时依赖旧版完全无风险：就算输出目录里存在旧版System.ValueTuple.dll，.NET Framework 4.8的CLR会通过绑定重定向自动将旧版引用指向系统自带的高版本。你可以查看项目生成的app.config，大概率能看到自动生成的重定向规则：

  <dependentAssembly>
    <assemblyIdentity name="System.ValueTuple" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-4.8.0.0" newVersion="4.8.0.0" />
  </dependentAssembly>
  

• 如果未自动生成，手动添加这段配置即可，强制CLR使用系统自带版本。

分发注意事项 #

• 无需向客户分发旧版System.ValueTuple.dll：4.8环境本身已内置该组件，额外分发反而可能引发加载冲突。将项目中System.ValueTuple的“复制本地”设置改为False，避免该DLL被复制到输出目录即可。

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