为何同一NuGet包的不同版本未还原至解决方案文件夹？

这个问题我之前帮不少开发者排查过，核心原因是NuGet在packages.config模式下的本地包存储逻辑和你预期的不一致——默认情况下，它不会自动把同一包的多个版本都保留在项目文件夹的packages目录里，只会优先保留其中一个版本（通常是第一个被解析到的版本），其他版本仅存于全局缓存$(UserProfile).nuget\packages\中。而你的v2.0项目找不到包，大概率是因为它的依赖路径配置指向了本地packages目录，而非全局缓存。

下面是几个针对性的解决方案，按推荐程度排序：

一、切换到PackageReference模式（推荐） #

PackageReference是NuGet现在的主流依赖管理方式，它天然支持同一解决方案中不同项目引用同一包的不同版本，而且完全依赖全局缓存，不需要本地packages目录，从根源上避免这类版本冲突问题。

操作步骤：

• 右键目标项目 → 选择「管理NuGet程序包」
• 点击右上角的齿轮图标（包源设置），在「包管理格式」中选择「PackageReference」
• 移除现有依赖后重新安装对应版本的包，或者直接修改项目文件：
  打开项目的.csproj文件，替换原有的<Reference>节点为PackageReference：

  <!-- 引用v1.0的项目 -->
  <ItemGroup>
    <PackageReference Include="你的NuGet包名" Version="1.0.0" />
  </ItemGroup>
  
  <!-- 引用v2.0的项目 -->
  <ItemGroup>
    <PackageReference Include="你的NuGet包名" Version="2.0.0" />
  </ItemGroup>
  

• 执行nuget restore重新还原，之后清理并重建解决方案即可。

二、强制NuGet在本地保留多版本（针对packages.config模式） #

如果你必须保留packages.config模式，可以通过修改NuGet配置，强制它在本地packages目录中保留同一包的多个版本：

1. 在解决方案根目录创建NuGet.Config文件，写入以下内容：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <config>
    <!-- 指定本地包存储路径 -->
    <add key="repositoryPath" value="$(SolutionDir)\packages" />
  </config>
  <packageRestore>
    <add key="enabled" value="True" />
    <add key="automatic" value="True" />
  </packageRestore>
  <!-- 关键配置：允许同一包的多个版本共存 -->
  <add key="allowDuplicateVersions" value="True" />
  <packageManagement>
    <add key="format" value="packages.config" />
  </packageManagement>
</configuration>

2. 执行强制还原命令：

nuget restore -force

3. 还原完成后，检查解决方案的packages目录，应该会出现两个版本的子文件夹，之后重新加载项目即可。

三、手动修正项目的依赖路径 #

如果以上两种方案都不适用，可以直接修改引用v2.0版本项目的.csproj文件，修正依赖的HintPath：

打开项目文件，找到对应包的<Reference>节点，把HintPath修改为全局缓存路径或者本地正确的版本路径：

<Reference Include="你的NuGet包名, Version=2.0.0.0, Culture=neutral, PublicKeyToken=xxx">
  <!-- 选项1：指向全局缓存 -->
  <HintPath>$(UserProfile)\.nuget\packages\你的NuGet包名\2.0.0\lib\netxxx\你的NuGet包名.dll</HintPath>
  <!-- 选项2：指向本地packages目录的v2.0版本 -->
  <!-- <HintPath>..\packages\你的NuGet包名.2.0.0\lib\netxxx\你的NuGet包名.dll</HintPath> -->
</Reference>

验证步骤 #

完成上述操作后，可以通过以下步骤确认问题解决：

• 执行nuget list 你的NuGet包名 -source $(UserProfile)\.nuget\packages，确认全局缓存中存在两个版本
• 检查解决方案的packages目录（如果用方案二），确认两个版本都已存在
• 清理解决方案 → 重新生成，查看v2.0项目是否还存在依赖缺失的异常

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