如何让app.config版本号与packages.config保持匹配？

问题背景 #

使用NuGet升级包（如System.ValueTuple）后，项目编译正常，但部署时出现“找不到指定版本文件”的错误。排查发现：

• packages.config中的版本与NuGet更新后的版本一致
• app.config中对应包的<assemblyBinding>节点里，oldVersion属性值为低于已安装版本的最高版本，导致程序集绑定失败

解决方案 #

1. 开启自动绑定重定向（推荐长期解决）

在项目的.csproj文件中添加以下配置，让Visual Studio在编译时自动生成/更新正确的程序集绑定重定向：

<PropertyGroup>
  <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
  <!-- 桌面应用需添加下面这行，Web应用可省略 -->
  <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
</PropertyGroup>

添加后重新编译项目，VS会自动更新app.config中的<assemblyBinding>节点，确保newVersion与已安装包版本一致，oldVersion覆盖所有旧版本范围（如0.0.0.0-2.0.0.0）。

2. 手动触发绑定重定向生成

如果不想修改项目文件，可通过VS界面或NuGet命令强制更新：

• VS界面操作：右键项目 → 属性 → 应用程序选项卡 → 点击「生成绑定重定向」按钮（Web项目可在Web选项卡找到对应功能）
• NuGet命令行：
  • 单个包更新：Update-Package -reinstall System.ValueTuple
  • 整个项目重新安装所有包（适合批量修复）：Update-Package -reinstall
    该命令会重新安装指定包/所有包，并同步更新app.config中的绑定重定向节点。

3. 清理旧绑定后重新生成

若自动生成仍有残留问题，可先手动删除app.config中所有<assemblyBinding>节点，再执行以下操作之一：

• 重新编译项目（开启自动绑定重定向的情况下）
• 运行Update-Package -reinstall命令
  VS会重新生成完全匹配当前NuGet包版本的绑定重定向。

注意事项 #

• 大型解决方案建议分项目处理，避免全量操作耗时过长
• 开启自动绑定重定向后，后续NuGet包升级会自动维护绑定节点，无需手动干预
• 操作后务必检查app.config，确认newVersion与packages.config中的包版本一致，oldVersion范围覆盖所有可能的旧版本

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