最可靠备份方式是手动导出settings.json和extensions-list.txt。需备份User目录下settings.json、keybindings.json、snippets/、tasks.json、launch.json;用code --list-extensions导出插件列表;还原时先覆盖settings.json再批量安装插件。

导出 VSCode 用户设置(settings.json)
VSCode 的用户级配置保存在 settings.json 文件里,直接复制它就是最轻量、最可靠的备份方式。别依赖“同步”开关——它依赖 GitHub 账户且可能丢配置项(比如某些插件的私有设置)。
操作路径取决于系统:
- Windows:
%APPDATA%\Code\User\settings.json -
macOS:
$HOME/Library/Application Support/Code/User/settings.json - Linux:
$HOME/.config/Code/User/settings.json
用文本编辑器打开后可手动清理敏感值(如 API key、本地路径),再存为 settings-backup-2024.json 这类带时间戳的文件。注意:不要覆盖原文件,避免误删。
一键导出已安装插件列表(extensions.json)
插件本身不能直接打包导出,但能快速生成可复用的安装清单。执行命令行导出比截图或手写更准,尤其适合重装系统后批量恢复。
在终端运行以下命令:
code --list-extensions > extensions-list.txt
这会输出所有启用插件的 ID(如 ms-python.python),不含版本号和禁用状态。若需区分启用/禁用,加 --show-versions 参数:
code --list-extensions --show-versions > extensions-with-versions.txt
注意:code 命令必须已加入系统 PATH;没配置的话,先在 VSCode 里按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P),输入 Shell Command: Install 'code' command in PATH 并执行。
还原设置与插件时的关键顺序
先还原设置,再装插件。否则部分插件(如 Prettier、ESLint)会在无对应配置时报错或行为异常。
- 把备份的
settings.json覆盖到原路径(确保 VSCode 已完全退出) - 执行
cat extensions-list.txt | xargs -L 1 code --install-extension
(macOS/Linux) - Windows 用户用 PowerShell:
Get-Content extensions-list.txt | ForEach-Object { code --install-extension $_ }
如果某个插件安装失败(比如网络问题),命令会中断。建议逐行执行或改用脚本加错误忽略(2>/dev/null || true)。
插件配置和全局快捷键容易被忽略
settings.json 不包含插件自身的配置(如 Python 插件的 python.defaultInterpreterPath),这些通常也存在同目录下的 keybindings.json 和 snippets/ 子目录中。
完整备份应包括:
settings.json-
keybindings.json(快捷键) -
snippets/目录(自定义代码片段) -
tasks.json和launch.json(如果用了自定义任务或调试配置)
这些文件都在同一级 User/ 目录下。只备份 settings.json 就像只记菜谱不记调料——看着全,做出来不是那个味。










