NuGet包未安装至解决方案packages子文件夹的原因及解决方法

原因分析 #

• .NET Framework项目默认用packages.config管理依赖，默认将包下载到解决方案根目录的packages文件夹。
• .NET Core/5+项目默认使用PackageReference管理依赖，NuGet默认的全局包存储路径就是\users\myid\packages（完整路径通常是C:\Users\<你的ID>\.nuget\packages）。
• 混合项目场景下，两种包管理格式的默认行为不同，导致部分包存到解决方案目录，部分存到全局路径。
• 若修改过NuGet配置文件（如NuGet.Config），也可能改变包的存储优先级，引发路径差异。

修复方案 #

方案1：添加解决方案级NuGet.Config（推荐，仅影响当前解决方案） #

在解决方案根目录创建或修改NuGet.Config文件，写入以下配置：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <config>
    <!-- 指定包存储到解决方案下的packages文件夹 -->
    <add key="globalPackagesFolder" value=".\packages" />
  </config>
</configuration>

保存后，重新还原NuGet包，新安装或还原的包会自动存到解决方案的packages文件夹。

方案2：修改Visual Studio全局NuGet设置（影响所有项目） #

1. 打开Visual Studio 2022，点击顶部菜单工具 → 选项
2. 左侧导航栏选择NuGet包管理器 → 常规
3. 在全局包文件夹输入框中，设置为目标解决方案的packages文件夹路径（例如D:\MySolution\packages）
4. 点击确定生效，之后所有项目的NuGet包都会默认存储到该路径。

迁移已安装的包到解决方案目录 #

1. 删除项目下的obj和bin文件夹，清理本地缓存
2. 右键解决方案，选择还原NuGet包，新配置生效后，NuGet会将包重新下载到指定的解决方案packages文件夹

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