如何迁移VSCode安装路径且不丢失扩展插件与设置配置

前置准备 #

• 完全关闭所有正在运行的VSCode进程，避免文件占用导致复制失败
• 提前在SSD上规划好VSCode安装目录，可选提前规划配置、扩展的存放目录

步骤1：定位VSCode核心目录 #

VSCode的文件分为两类，你可以根据需求选择只迁移安装程序，或者同时迁移配置、扩展到SSD：

1. 安装目录：存放VSCode主程序文件，默认路径如下：
   • Windows：C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code
   • macOS：/Applications/Visual Studio Code.app
   • Linux：默认安装路径为/usr/share/code，手动解压版为你自定义的解压目录
2. 用户数据目录：存放所有自定义设置、已安装扩展、快捷键配置、工作区记录等内容，默认路径如下：
   • 配置目录：
     • Windows：C:\Users\你的用户名\AppData\Roaming\Code
     • macOS：~/Library/Application Support/Code
     • Linux：~/.config/Code
   • 扩展目录：所有系统通用默认路径为~/.vscode/extensions（Windows对应为C:\Users\你的用户名\.vscode\extensions）

步骤2：迁移VSCode主程序 #

• 将HDD上的VSCode安装目录完整复制到SSD提前规划好的目录下
• 临时将HDD上的原安装目录重命名为Microsoft VS Code_old，不要立即删除，用于迁移失败回滚

步骤3：可选-同步迁移配置与扩展到SSD #

如果你希望把配置、扩展也放到SSD提升加载速度，执行以下操作，否则可以直接跳过该步骤：

• 将上述提到的配置目录和扩展目录完整复制到SSD的自定义目录下，例如Windows下可以放到D:\VSCodeData\Code和D:\VSCodeData\extensions
• 右键点击SSD中新的VSCode启动程序（Windows下为Code.exe），选择「发送到-桌面快捷方式」，右键该快捷方式选择「属性」，在「目标」输入框的原有内容末尾添加参数：

  --user-data-dir "你SSD上的新配置目录路径" --extensions-dir "你SSD上的新扩展目录路径"
  

  注意参数前需要加1个空格，例如修改后完整目标路径为：
  D:\Programs\Microsoft VS Code\Code.exe --user-data-dir "D:\VSCodeData\Code" --extensions-dir "D:\VSCodeData\extensions"

步骤4：功能验证 #

• 双击新的快捷方式启动VSCode，检查已安装扩展、自定义主题、快捷键、工作区记录是否完整保留
• 尝试打开几个本地项目，确认文件读写、功能运行无异常
• 如果启动失败或者数据缺失，删除新复制的文件，将原安装目录改回原名即可回滚

步骤5：后续处理 #

• 验证迁移正常后，可以删除HDD上的旧安装目录、旧配置/扩展目录（如果已经迁到SSD）、旧启动快捷方式
• 如果你发现右键菜单的「通过Code打开」选项仍然指向旧的HDD路径，无需手动修改注册表，直接下载VSCode官方安装包，安装路径选择SSD上的新安装目录覆盖安装即可，该操作不会修改你的任何配置与扩展，会自动修复所有系统关联

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