如何备份与恢复你的VSCode完整开发环境

19次阅读

最稳方式是结合vscode官方Settings Sync、手动备份User目录及扩展、同步.gitignore未忽略的.vscode项目配置和.code-workspace文件,并按“先同步再覆盖最后检查”顺序恢复。

如何备份与恢复你的VSCode完整开发环境

直接备份 VSCode 的完整开发环境,关键不是只复制配置文件,而是把 设置、扩展、快捷键、代码片段、工作区设置、甚至自定义主题和字体配置 一并带走。手动一个个导出太麻烦,也容易遗漏——最稳的方式是结合 VSCode 自带功能 + 系统级文件备份,再加一层云同步保障。

一、用 Settings Sync(官方同步)快速跨设备恢复

VSCode 内置的 Settings Sync 功能(基于 github/gitlab 账户)能自动同步绝大部分核心配置:

  • 用户设置(settings.json)、键盘快捷键(keybindings.json)、代码片段(snippets/ 目录)
  • 已安装扩展列表(extensions list),重装时自动批量下载安装
  • 已启用/禁用的扩展状态、工作区信任设置、部分调试配置

注意:它不备份扩展的本地缓存、扩展自身的配置文件(如 Prettier 或 ESLint 的独立 jsON)、或你放在项目里的 .vscode/ 文件夹内容(除非你主动提交到 Git)。开启方式:命令面板(Ctrl+Shift+P)→ 输入 “Turn on Settings Sync” → 登录 GitHub 即可。

二、手动备份关键配置文件与扩展目录

Settings Sync 有盲区,必须手动补全。找到你的 VSCode 用户数据目录(路径因系统而异):

  • windows%appDATA%CodeUser(含 settings.json、keybindings.json、snippets/、extensions/)
  • macOS~/Library/Application Support/Code/User/
  • linux~/.config/Code/User/

建议定期压缩整个 User/ 目录(含 extensions/ 子目录),并保存到本地或私有云。扩展本身体积大,若只备份扩展清单,可用终端执行:
code --list-extensions > extensions-list.txt,恢复时运行 xargs -n 1 code --install-extension 。

三、别漏掉工作区级和项目级配置

全局设置管不住具体项目需求。这些要单独处理:

  • .vscode/ 文件夹(在项目根目录):含 tasks.json、launch.json、settings.json(项目专属)、extensions.json(推荐本项目用的扩展)
  • 这类文件应随项目一起纳入 Git 版本管理(.gitignore 里不要忽略 .vscode/)
  • 如果用了多根工作区(.code-workspace 文件),这个 JSON 文件也要备份——它记录了所有打开的文件夹路径和工作区设置

四、恢复时按顺序操作,避免冲突

重装系统或换电脑后,别急着开 VSCode:

  • 先安装 VSCode,登录 Settings Sync 并同步(它会拉取设置和扩展列表)
  • 再覆盖粘贴你手动备份的 User/ 目录(尤其 snippets/ 和 keybindings.json)
  • 最后打开项目,检查 .vscode/ 配置是否生效;如有扩展需要额外配置(比如 python 解释器路径、ESLint 插件绑定),再手动设一次

基本上就这些。不复杂但容易忽略细节——尤其是 snippets 和工作区配置,一丢就得重写一遍。养成每月打个包的习惯,比崩溃后抓瞎强太多。

text=ZqhQzanResources