直接复制整个 VSCode 用户数据目录即可完整备份和恢复环境,包括设置、插件、快捷键、Snippets 和调试配置;Windows 在 %APPDATA%Code,macOS 在 ~/Library/Application Support/Code,Linux 在 ~/.config/Code。

直接复制整个 VSCode 配置目录就能完整备份和恢复你的环境,包括设置、插件、快捷键、代码片段、Snippets 甚至调试配置。核心是用户数据目录(User Data Directory),不是安装目录。
找到并备份你的 VSCode 用户数据目录
这个目录存了你所有个性化内容,不同系统位置不同:
- Windows:C:UsersAppDataRoamingCode
- macOS:~/Library/Application Support/Code
- Linux:~/.config/Code
关闭 VSCode 后,把整个 Code 文件夹压缩打包(比如叫 vscode-backup-2024.zip),就是最稳妥的备份。不需要单独导出插件列表或手动记设置。
快速恢复:替换用户数据目录即可
在新机器或重装后,按对应路径找到目标系统的 Code 目录(若不存在可先启动一次 VSCode 再退出,自动生成),然后用备份的文件夹直接覆盖(建议先重命名原文件夹留作备用)。重启 VSCode,所有设置、已装插件、快捷键绑定、自定义 Snippets 全部还原。
注意:如果只覆盖 User 子目录(如 Code/User),也能恢复大部分内容,但插件会丢失——因为插件实际安装在 Code/Cache 和 Code/Extensions 中,所以推荐整目录覆盖。
补充方案:同步设置(适合多设备轻量更新)
VSCode 内置的 Settings Sync 功能(需登录 GitHub 账号)能自动同步设置、插件、快捷键、Snippets 等,适合日常跨设备保持一致。但它依赖网络和账号,且不保存本地插件缓存或某些扩展的私有状态。作为日常辅助很好,但不能替代本地完整备份。
启用方式:命令面板(Ctrl+Shift+P / Cmd+Shift+P)→ 输入 Sync: Turn on → 登录 GitHub → 选择要同步的内容项。
小技巧:导出 / 导入插件列表(应急用)
如果只想迁移插件(比如换平台但不想复制整个目录),可在终端运行:
- 导出:
code --list-extensions > extensions.txt - 安装:
cat extensions.txt | xargs -I {} code --install-extension {}(macOS/Linux)或 Windows PowerShell 中用Get-Content extensions.txt | ForEach-Object {code --install-extension $_}
但这只装插件,不恢复插件配置、设置或快捷键,属于“半恢复”,适合极简场景。
基本上就这些。整目录备份最可靠,Settings Sync 最方便,两者搭配用最安心。