完整备份VSCode配置需同步设置、扩展、快捷键等。1. 手动备份User目录下settings.json、keybindings.json、snippets等文件;2. 通过code --list-extensions导出扩展列表并保存至vscode-extensions.txt;3. 使用内置Settings Sync功能,登录GitHub账号自动同步所有配置到Gist;4. 进阶用户可将配置文件软链接至Git仓库,结合脚本实现版本控制与多机同步。推荐优先使用Settings Sync,兼顾便捷与完整性,手动备份适合隐私场景,Git方案利于长期维护,关键在于定期更新备份避免丢失。

备份 VSCode 的完整配置,不只是复制几个文件那么简单。你需要确保设置、扩展列表、快捷键、代码片段,甚至窗口布局都能在新环境还原。下面介绍几种实用方法,帮你完整保存开发环境。
1. 手动备份关键配置文件
VSCode 的用户数据分散在特定目录中,找到它们并打包即可实现本地备份。步骤如下:
- 关闭 VSCode
- 进入用户配置目录(根据操作系统不同路径有差异):
-
Windows:
%APPDATA%\Code\User\ -
macOS:
~/Library/Application Support/Code/User/ -
Linux:
~/.config/Code/User/
-
Windows:
- 备份以下文件和文件夹:
-
settings.json—— 所有自定义设置 -
keybindings.json—— 自定义快捷键 -
snippets/—— 用户代码片段 -
suggest.json(可选)—— 输入建议状态
-
这些文件保存了你的个性化设置,但不包括已安装的扩展。
2. 备份已安装的扩展列表
扩展是 VSCode 功能的核心,只记名字不够,最好导出完整清单。导出扩展列表:
- 打开终端或命令行
- 运行命令:
code --list-extensions > vscode-extensions.txt
- 该命令会生成一个包含所有已安装扩展 ID 的文本文件
恢复时批量安装:
cat vscode-extensions.txt | xargs -L 1 code --install-extension
(Windows 可使用 PowerShell 实现类似功能)
3. 使用 Settings Sync(推荐)
VSCode 内置的同步功能,能自动备份到 GitHub 账号。启用步骤:
- 打开命令面板
Ctrl+Shift+P - 输入并选择:
Turn on Settings Sync - 登录 GitHub 账号
- 选择要同步的内容:设置、扩展、快捷键、代码片段等
开启后,所有配置会加密上传到 GitHub Gist。换设备登录同一账号,一键恢复全部环境。
你也可以随时暂停同步或查看同步状态,在右下角点击账号图标管理。
4. 定期归档 + 版本控制(进阶)
如果你追求更精细的控制,可以把配置文件纳入 Git 管理。操作建议:
- 将
User/目录软链接到一个 Git 仓库 - 提交每次重要修改
- 添加
vscode-extensions.txt到仓库中 - 写个脚本自动导出扩展并提交
这样不仅能回溯历史版本,还能在多台机器间手动同步。
基本上就这些。用 Settings Sync 最省心,手动备份适合隐私敏感场景,结合 Git 更适合开发者长期维护。关键是定期更新备份,别等到重装系统才想起来。










