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

直接备份 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%\Code\User\(含 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 和工作区配置,一丢就得重写一遍。养成每月打个包的习惯,比崩溃后抓瞎强太多。









