如何强制将指定NuGet包下载至本地Packages文件夹？

我来帮你搞定这个NuGet包存储路径的麻烦——这个场景我之前在团队构建服务器上也碰到过，咱们一步步理清楚：

首先得明确一个核心点：你的.NET Core项目用的是PackageReference格式（没有packages.config），这种格式下NuGet默认会把包存在全局缓存里（比如Windows的%USERPROFILE%\.nuget\packages，Linux/macOS的~/.nuget/packages）。而你本地出现的Packages/Newtonsoft.Json.12.0.1那种带版本号的文件夹名，其实是传统packages.config时代的存储格式，这说明你的本地环境肯定有特殊的NuGet配置在生效。

要在构建服务器上统一行为，同时避免重复下载已经在全局缓存里的包，可以按下面的方法操作：

1. 用NuGet.config统一配置（推荐方案） #

在你的解决方案根目录创建或者修改一个NuGet.config文件，通过这个配置指定本地包存储路径，同时让NuGet优先用全局缓存里的包，不用重新下载：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <config>
    <!-- 把PackageReference的包存到解决方案下的Packages文件夹 -->
    <add key="globalPackagesFolder" value=".\Packages" />
    <!-- 让NuGet用全局缓存当备用，已有包直接复制，不用重新下载 -->
    <add key="cachePath" value="%USERPROFILE%\.nuget\packages" />
  </config>
  <packageSources>
    <!-- 保留官方NuGet源 -->
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
</configuration>

关键配置说明： #

• globalPackagesFolder：指定PackageReference格式的包存储路径，结构会是包名/版本号（比如Packages/Newtonsoft.Json/12.0.1），这是PackageReference的标准结构，和你提到的强制下载后的格式一致。虽然和你本地的格式不一样，但这是.NET Core项目的标准做法，能避免很多奇怪的兼容性问题。
• cachePath：指定NuGet的缓存目录指向全局缓存，这样如果服务器的全局缓存里已经有Newtonsoft.Json 12.0.1，NuGet会直接把它复制到你的解决方案Packages文件夹，不会重新下载，省流量也省时间。

2. 构建服务器上的执行命令 #

在构建服务器上，进入你的解决方案目录，执行这条命令就行：

dotnet restore --configfile NuGet.config

这条命令会强制使用你刚写的自定义配置，包就会乖乖存到解决方案的Packages文件夹里了。

3. 为什么不建议执着于Newtonsoft.Json.12.0.1格式？ #

你本地那种带版本号的文件夹名是packages.config时代的产物，.NET Core的PackageReference根本不支持这种格式——硬要凑这个格式的话，只会让NuGet行为混乱，甚至构建失败。不如直接统一用PackageReference的标准结构，这才是长期可靠的方案。

4. 特殊需求的替代方案：本地包源 #

如果你确实需要把某个特定包（比如Json.Net）单独放到指定路径，可以搞个本地包源：

1. 在解决方案下建个LocalPackages文件夹
2. 执行这条命令把指定版本的Json.Net下载到这个文件夹：

nuget install Newtonsoft.Json -Version 12.0.1 -OutputDirectory .\LocalPackages -Source https://api.nuget.org/v3/index.json

3. 把这个本地源加到NuGet.config里：

<packageSources>
  <add key="LocalPackages" value=".\LocalPackages" />
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
</packageSources>

4. 之后执行dotnet restore时，NuGet会先看本地源有没有这个包，不用再去远程下载

不过这个方案需要手动维护本地包源，适合那种必须严格控制包版本、不让构建过程依赖外部网络的场景。

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