Windows
## 迁移NuGet本地缓存到D盘的完整方案
### 一、核心原理说明
NuGet的本地缓存位置由环境变量或全局配置文件控制，我们可以通过修改这两个方式实现迁移，以下是两种最可靠的方案：
#### 方案1：通过环境变量修改（推荐，全局生效）
这是官方推荐的方式，对所有.NET版本和IDE（VS/Rider）都生效。
操作步骤：
1. 关闭所有使用NuGet的程序（Visual Studio、Rider、命令行终端等）
2. 复制现有缓存到目标路径
powershell
以管理员身份打开PowerShell执行
Copy-Item -Path "C:\Users\Administrator\.nuget" -Destination "D:\.nuget" -Recurse -Force
3. 设置环境变量
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
在用户变量区域：
点击「新建」，变量名：NUGET_PACKAGES，变量值：D:\.nuget\packages
（可选）如果需要配置全局缓存，在系统变量区域添加同样的变量
4. 验证是否生效
打开新的PowerShell终端执行：
powershell
nuget locals all -list
输出中应显示global-packages: D:\.nuget\packages
#### 方案2：通过NuGet配置文件修改（灵活，可针对单个项目）
适合需要多缓存路径或不想修改环境变量的场景。
操作步骤：
1. 复制现有缓存到目标路径（同方案1的步骤2）
2. 修改全局配置文件
编辑文件 C:\Users\Administrator\AppData\Roaming\NuGet\NuGet.Config，添加以下配置：
xml
3. 可选：项目级配置
在项目目录的NuGet.Config中添加同样的config节点，可覆盖全局配置
### 二、关键注意事项
⚠️ 重要警告：
1. 迁移前必须关闭所有依赖NuGet的程序，否则可能导致文件占用无法复制
2. 不要直接删除原C盘缓存，建议先验证新路径生效后再删除
3. 如果使用Visual Studio，需要重启IDE才能加载新的配置
### 三、常见问题排查
| 问题现象 | 排查方向 |
|---------|---------|
| 新路径未生效 | 检查环境变量是否正确设置，是否重启了终端/IDE |
| 包下载失败 | 检查目标路径是否有读写权限，建议给D:\.nuget文件夹赋予当前用户完全控制权限 |
| Visual Studio仍使用旧路径 | 清理VS缓存：Tools→NuGet Package Manager→Package Manager Settings→Clear All NuGet Cache(s) |
### 下一步行动建议
完成迁移后，建议执行以下命令验证：
powershell
清理旧缓存
nuget locals all -clear
安装一个测试包，验证新路径是否被使用
Install-Package Newtonsoft.Json -Source nuget.org
然后检查D:\.nuget\packages下是否出现Newtonsoft.Json文件夹，确认迁移成功。
## 迁移.nuget文件夹到d盘
### 计划步骤：
1. **确认.nuget文件夹位置**
`.nuget` 文件夹通常是旧版 Visual Studio 项目（如 VS2010 - VS2013）中用于存储 NuGet 相关工具和包的本地文件夹，一般位于**解决方案根目录**（和 `.sln` 文件同级的 `.nuget` 文件夹）或**用户目录**（如 `%AppData%\NuGet` 相关，但较少见）。
需要先找到你项目里具体的 `.nuget` 文件夹路径（比如 `C:\项目路径\.nuget`）。
2. **关闭 Visual Studio**
确保所有 Visual Studio 实例都已关闭，避免文件被占用导致迁移失败。
3. **复制 .nuget 文件夹到 D 盘**
将原位置的 `.nuget` 文件夹（例如 `C:\项目路径\.nuget`）**完整复制**到 D 盘的目标位置（例如 `D:\NuGetBackup\.nuget`）。
4. **修改项目配置，指向新的 .nuget 文件夹路径（关键步骤）**
- 打开项目根目录下的 `.nuget` 文件夹，里面通常有 `NuGet.exe`、`NuGet.Config`（如果有）以及 `packages.config` 等文件。
- **重点：** 如果你的项目是通过 `packages.config` 管理 NuGet 包，并且依赖本地的 `.nuget\nuget.exe` 来还原包，那么需要修改项目文件（`.csproj`）或解决方案的构建逻辑，使其指向 D 盘的新 `.nuget` 文件夹。
- 但由于 `.nuget` 文件夹传统上是**本地辅助文件夹**，更推荐的方式是**直接弃用项目内的 .nuget 文件夹**，改用**全局 NuGet 配置和缓存机制**（即让 NuGet 自动从官方源下载包并存在用户目录或自定义的全局包目录，而不是每个项目放一个 .nuget）。
5. **推荐做法：弃用项目内 .nuget 文件夹，改用标准 NuGet 包还原方式**
- **删除项目中的 .nuget 文件夹**（比如从 `C:\项目路径\` 下删除 `.nuget`）。
- **将 .nuget 文件夹内容（如 NuGet.exe）迁移到 D 盘（可选，一般不需要）**。
- **修改项目，使用 Visual Studio 默认的 NuGet 包还原机制**：
- 确保项目使用的是 `packages.config` 或 `PackageReference`（新版推荐）。
- 在 Visual Studio 中启用“自动还原 NuGet 包”功能（默认开启）。
- NuGet 会自动从 nuget.org 下载包，并存放在用户目录下的全局缓存中（通常是 `%UserProfile%\.nuget\packages` 或 `%LocalAppData%\NuGet\v3-cache`），**不需要每个项目都放一个 .nuget 文件夹**。
6. **如果一定要保留 .nuget 文件夹在 D 盘并在项目中引用它（不推荐）**
- 你可以手动将 `.nuget` 文件夹复制到 D 盘（如 `D:\MyNuGet\.nuget`）。
- 然后**修改项目文件（.csproj）**，将其中引用 `$(SolutionDir)\.nuget\nuget.exe` 的地方，改成 `D:\MyNuGet\.nuget
uget.exe`（需用文本编辑器编辑 `.csproj` 文件，搜索 `.nuget
uget.exe` 并替换路径）。
- **但这种方式非常不推荐**，因为现代 Visual Studio 和 .NET 项目已不再依赖项目内的 .nuget 文件夹。
---
### 推荐的标准做法（无需迁移 .nuget 文件夹）：
> **现代 Visual Studio 项目（特别是使用 SDK 风格的项目，如 .NET Core / .NET 5+ / .NET Standard）已经不再使用项目内的 .nuget 文件夹了！**
> NuGet 包会自动从 nuget.org 下载并缓存在以下位置（无需你手动管理 .nuget 文件夹）：
> - 用户级包缓存：`%UserProfile%\.nuget\packages`
> - NuGet v3 缓存：`%LocalAppData%\NuGet\v3-cache`
**你应该做的是：**
1. **删除项目中的 .nuget 文件夹（如 `C:\项目路径\.nuget`）**。
2. **使用 Visual Studio 默认的 NuGet 包还原机制**（确保勾选“还原 NuGet 包”选项，或使用 `dotnet restore` 命令）。
3. **如需自定义 NuGet 包存储位置，可以配置全局包目录（见下文）**。
---
### 如何自定义 NuGet 全局包存储位置（推荐，替代迁移 .nuget 文件夹）：
如果你想把 **NuGet 下载的包（packages）** 存放到 D 盘（而不是默认的用户目录），可以这样做：
#### 方法一：通过 NuGet.Config 文件配置（推荐）
1. **在项目根目录或用户目录创建/修改 `NuGet.Config` 文件**
例如，在项目根目录新建一个 `NuGet.Config` 文件，内容如下：
```xml
```
2. **保存后，重新打开项目或执行还原命令**
- Visual Studio 会在下次还原 NuGet 包时，将下载的包存到 `D:\NuGetPackages` 文件夹中，而不是默认位置。
- 你也可以将该文件放到 `%AppData%\NuGet\NuGet.Config`（用户级全局配置）来影响所有项目。
3. **手动执行包还原（可选）**
在项目目录打开 CMD，运行：
```cmd
nuget restore
```
或对于 .NET Core / .NET 5+ 项目：
```cmd
dotnet restore
```
---
### 总结（简洁版）：
| 目标 | 是否需要迁移 .nuget 文件夹 | 推荐做法 |
|------|--------------------------|---------|
| 迁移项目里的 `.nuget` 文件夹（旧版 VS 辅助文件夹） | ✅ 可迁移，但不推荐 | **直接删除项目中的 .nuget 文件夹，使用 Visual Studio 默认 NuGet 包还原机制** |
| 迁移 NuGet 下载的包（如 packages）存储位置 | ❌ 无需迁移 .nuget 文件夹 | **通过 NuGet.Config 配置 `globalPackagesFolder` 到 D 盘（如 `D:\NuGetPackages`）** |
| 迁移 NuGet 缓存（v3-cache） | ❌ 与 .nuget 文件夹无关 | **可通过符号链接或配置迁移到 D 盘（如 `D:\NuGetCache\v3-cache`）** |
---
### 如果你坚持要迁移项目内的 .nuget 文件夹（不推荐）：
1. **关闭 Visual Studio**
2. **将项目中的 `.nuget` 文件夹（如 `C:\项目路径\.nuget`）复制到 D 盘（如 `D:\MyNuGet\.nuget`）**
3. **用文本编辑器打开项目 `.csproj` 文件，找到引用 `.nuget
uget.exe` 的地方，修改为新的路径（如 `D:\MyNuGet\.nuget
uget.exe`）**
4. **重新打开项目测试**
> ⚠️ 注意：此方法仅适用于非常旧的项目（VS2010~VS2013，使用 `packages.config` 且依赖项目内 .nuget 文件夹），**现代项目不需要 .nuget 文件夹**。
---
### 最推荐的解决方案（针对大多数用户）：
🔹 **删除项目中的 .nuget 文件夹**
🔹 **使用 Visual Studio / `dotnet restore` 自动管理 NuGet 包**
🔹 **如需自定义包存储位置，通过 `NuGet.Config` 文件设置 `globalPackagesFolder` 指向 D 盘目录（如 `D:\NuGetPackages`）**
如你需要具体的 `NuGet.Config` 配置模板或命令行操作，请告诉我你的项目类型（如 .NET Framework / .NET Core / SDK 风格项目等）。