C盘爆满 修改VS Code缓存与插件目录指定方法

C盘爆满 修改VS Code缓存与插件目录指定方法

当C盘因VS Code的缓存、插件及配置文件堆积而爆满时，可通过以下三种核心方式将相关数据定向到非C盘目录，实现C盘空间释放，同时保证VS Code正常使用。三种方法覆盖从简单到进阶的不同需求，环境变量方式若配置无效，符号链接为终极替代方案，文档同步补充.vscode插件目录的单独迁移方法。

一、方法一：修改快捷方式（简单易操作，推荐新手）

该方法仅调整VS Code启动快捷方式参数，无需修改系统全局配置，适合单台电脑、单一快捷方式使用场景，参数优先级高于环境变量和符号链接。

1.1 操作步骤

1. 彻底关闭VS Code：关闭所有VS Code窗口，打开任务管理器（Ctrl+Shift+Esc），结束"Code.exe""Code Helper.exe"等所有相关进程，避免文件占用。

2. 定位VS Code快捷方式：在桌面、开始菜单或任务栏中找到VS Code图标，右键点击，选择「属性」。

3. 修改"目标"参数 ：切换到「快捷方式」选项卡，在"目标"输入框的原有路径后，添加指定"用户数据（含插件）"和"缓存"目录的参数，格式如下：
   "C:\Users\Administrator\AppData\Local\Programs\Microsoft VS Code\Code.exe" --user-data-dir "D:\VSCodeData\UserData" --cache-dir "D:\VSCodeData\Cache"✅ 关键说明：

   • --user-data-dir：指定用户数据（含settings.json配置、快捷键、已安装插件）的存储目录；

   • --cache-dir：指定缓存文件（日志、工作区索引、临时文件）的存储目录；

   • 将示例中的"D:\VSCodeData\UserData""D:\VSCodeData\Cache"替换为自定义非C盘路径，路径需用英文双引号包裹，参数与原路径之间保留1个空格。

4. 保存并验证：点击「确定」保存参数，双击修改后的快捷方式启动VS Code，新的插件、缓存数据会自动写入指定的非C盘目录。

1.2 完整示例（目标参数参考）

"C:\Program Files\Microsoft VS Code\Code.exe" --user-data-dir "D:\Dev\VSCode\Data" --cache-dir "D:\Dev\VSCode\Cache"

1.3 极简版：仅迁移缓存（保留插件/配置在C盘）

若仅需释放缓存占用的C盘空间，无需迁移插件和配置，仅添加--cache-dir参数即可：

"C:\Program Files\Microsoft VS Code\Code.exe" --cache-dir "D:\Dev\VSCode\Cache"

二、方法二：修改系统环境变量（全局生效，适合多快捷方式）

通过配置系统环境变量，可让VS Code的所有启动方式（快捷方式、命令行、右键"用VS Code打开"）均生效，插件目录随用户数据目录同步迁移。若配置后目录未变化，需先完成排查步骤，仍无效则切换至符号链接方式。

2.1 操作步骤

1. 关闭VS Code及相关进程：同方法一第一步，确保无VS Code进程后台运行。

2. 打开环境变量配置界面：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。

3. 新建用户环境变量 ：在「用户变量」区域点击「新建」，依次添加两个变量（变量名大小写敏感，不可写错），具体如下表：

   变量名变量值（替换为自定义非C盘目录）作用VSCODE_USER_DATA_DIRD:\VSCodeData\UserData指定用户数据+插件存储目录VSCODE_CACHE_DIRD:\VSCodeData\Cache指定纯缓存文件存储目录

4. 生效配置 ：点击「确定」保存所有设置，重启电脑（确保环境变量全局生效），之后启动VS Code即可。

2.2 环境变量配置无效排查步骤

若配置后插件/缓存目录未变化，按以下优先级排查：

1. 验证变量是否生效 ：按Win+R打开"运行"，输入"cmd"打开命令提示符，依次执行以下命令，若输出为空或路径错误，说明变量未保存成功，需重新配置并重启电脑：
   echo %VSCODE_USER_DATA_DIR% echo %VSCODE_CACHE_DIR%

2. 清理快捷方式残留参数 ：检查所有VS Code快捷方式的"目标"参数，删除其中的--user-data-dir、--cache-dir相关内容，仅保留原始的"Code.exe"路径。

3. 彻底终止残留进程：任务管理器中再次确认所有VS Code相关进程已结束，重新启动软件。

4. 检查路径合法性：自定义的非C盘目录需手动新建，路径中不可包含中文、空格或特殊符号（如★、&、#）。

三、方法三：创建符号链接（软链接）------ 环境变量无效的终极方案

通过Windows自带的mklink命令创建目录软链接，将VS Code默认C盘目录映射到非C盘，对软件完全透明，可解决环境变量、快捷方式配置无效的问题。支持"整体迁移（缓存+插件+配置）"和"单独迁移.vscode插件目录"两种场景。

3.1 核心命令说明

需以管理员权限 执行命令，核心参数为/D（用于创建目录软链接），通用命令格式：

mklink /D "VS Code原C盘目录路径" "自定义非C盘目标目录路径"

补充参数说明：

参数	作用	适用场景
/J	创建目录交接点	跨分区目录链接，兼容性补充（效果与/D一致）
/H	创建硬链接	仅支持同一分区单个文件，不推荐用于目录迁移

3.2 实操一：整体迁移（缓存+插件+所有配置，推荐）

将VS Code默认目录%APPDATA%\Code（实际路径：C:\Users\Administrator\AppData\Roaming\Code）整体迁移到非C盘，插件目录随之一并迁移。

步骤1：准备工作（必须执行）

1. 彻底关闭VS Code及相关进程（同方法一第一步）。

2. 手动新建非C盘目标目录：例如"D:\VSCodeData\Code"，确保路径为纯英文/数字，无中文、空格。

3. 备份原有配置/插件（可选）：将默认目录"C:\Users\Administrator\AppData\Roaming\Code"下的"User"（配置文件）、"extensions"（插件）文件夹，复制到目标目录"D:\VSCodeData\Code"，保留原有设置和插件。

4. 删除原默认目录：删除"C:\Users\Administrator\AppData\Roaming\Code"（已备份则放心删除，否则会导致链接创建失败）。

步骤2：创建软链接（管理员终端执行）

1. 按Win+X，选择「Windows终端（管理员）」或「命令提示符（管理员）」。

2. 执行适配自身路径的软链接命令（直接替换示例路径即可）：
   mklink /D "C:\Users\Administrator\AppData\Roaming\Code" "D:\VSCodeData\Code"

3. 成功验证：终端显示"Symbolic link created for 原路径 <<===>> 目标路径"，说明软链接创建完成。

3.3 实操二：单独迁移.vscode插件目录（按需选择）

若仅需迁移插件目录（默认路径：C:\Users\Administrator.vscode），保留其他配置在C盘，按以下步骤操作：

步骤1：准备工作

1. 关闭VS Code及相关进程。

2. 手动新建非C盘插件目标目录：例如"D:\VSCodeData.vscode"。

3. 备份原插件目录：将"C:\Users\Administrator.vscode"下所有文件/文件夹，复制到"D:\VSCodeData.vscode"。

4. 删除原插件目录：删除"C:\Users\Administrator.vscode"。

步骤2：创建插件目录软链接

管理员终端执行以下命令：

mklink /D "C:\Users\Administrator\.vscode" "D:\VSCodeData\.vscode"

3.4 软链接相关常见操作

1. 删除软链接（不删除目标目录数据） ：管理员终端执行"rd 原C盘链接路径"（不要加/s参数，否则会删除目标目录所有内容），示例：
   rd "C:\Users\Administrator\AppData\Roaming\Code" rd "C:\Users\Administrator\.vscode"

2. PowerShell创建软链接（替代CMD） ：管理员PowerShell执行以下命令，效果与"mklink /D"一致：

   `# 整体迁移Code目录

   New-Item -ItemType SymbolicLink -Path "C:\Users\Administrator\AppData\Roaming\Code" -Target "D:\VSCodeData\Code"

单独迁移.vscode插件目录

New-Item -ItemType SymbolicLink -Path "C:\Users\Administrator.vscode" -Target "D:\VSCodeData.vscode"`

3. 软链接失效修复：若目标目录被移动/删除，重新创建目标目录并放回备份数据，或删除旧链接重新执行创建命令即可。

四、通用关键注意事项（所有方法均适用）

1. 目录提前创建：所有自定义的非C盘目标目录（缓存、用户数据、插件），需手动新建后再配置参数/创建链接，避免VS Code启动报错。

2. 路径规范：目标路径不要包含中文、空格、特殊符号（如★、&、#），建议用纯英文/数字/下划线，示例：D:\Dev\VSCode\Cache、D:\VSCodeData.vscode。

3. 插件/配置迁移：若想保留原有VS Code设置、快捷键、已安装插件，需将原目录下对应文件夹复制到新目录：

   • 整体迁移：复制"C:\Users\Administrator\AppData\Roaming\Code"下的"User"和"extensions"；

   • 单独迁移插件：复制"C:\Users\Administrator.vscode"下所有文件。

4. 参数优先级：快捷方式参数 > 环境变量 > 符号链接，若多种方式同时配置，以优先级高的为准；配置符号链接前，建议清空快捷方式参数、删除环境变量，避免冲突。

5. 避免误删：创建软链接后，原C盘路径会显示为"快捷方式样式"，不要直接删除该链接的子文件，如需清理数据，直接在非C盘目标目录操作。

五、验证是否生效（通用方法）

启动VS Code后，按Ctrl+Shift+P打开命令面板，执行对应命令验证路径，若指向自定义非C盘目录即说明生效：

1. 验证缓存/日志目录：执行「Developer: Open Logs Folder」，查看日志文件所在路径；

2. 验证用户数据/插件目录：执行「Developer: Open User Settings」，查看"settings.json"所在路径，插件随该目录同步迁移；

3. 验证.vscode插件目录：直接打开"C:\Users\Administrator.vscode"，右键→「属性」，查看"目标位置"是否为自定义非C盘路径（软链接方式）。

六、方法选择总结

1. 新手/单快捷方式使用：优先选「方法一（修改快捷方式）」，操作简单、无系统全局影响，可同时指定缓存和插件目录；

2. 多启动方式/全局生效：优先试「方法二（环境变量）」，无效则直接切换「方法三（符号链接）」；

3. 环境变量/快捷方式均配置失败/C盘爆满急需解决：「方法三（符号链接）」是终极解决方案，支持整体/单独迁移插件目录，对软件透明、稳定无兼容问题；

4. 仅想迁移插件目录：直接用「方法三的单独迁移.vscode插件目录」操作，步骤更精简。