仅备份 settings.json 无法还原完整开发环境，因缺少扩展、快捷键、代码片段及工作区配置；settings sync 不同步扩展配置文件、.vscode/ 内容、本地缓存、ai插件登录态和 .code-workspace 文件。
只备份 settings.json 就想还原整个开发环境？不行。缺了扩展、快捷键、代码片段或工作区配置，打开 VSCode 还是得重装重配。
为什么 Settings Sync 有时同步不全
VSCode 内置的 Settings Sync（通过 GitHub 或 Microsoft 账户）确实能自动拉取 settings.json、keybindings.json、snippets/ 和已安装扩展列表，但它不保存：
- 扩展自身的配置文件（比如
.prettierrc、.eslintrc.js这类放在项目里或用户目录下的独立配置） - 项目级
.vscode/目录内容（tasks.json、launch.json、extensions.json） - 扩展本地缓存、二进制依赖、或需要额外授权的插件状态（如某些 AI 插件的登录态）
-
.code-workspace多根工作区文件（它记录的是绝对路径，跨机器直接恢复会失效）
所以，启用 Settings Sync 后仍需手动检查 .vscode/ 是否已提交到 Git，以及关键扩展是否真正完成初始化。
手动备份 User 目录时容易漏掉的三个位置
VSCode 所有用户级配置都集中在 User 目录下，但不同系统路径不同，且容易忽略子目录：
- Windows：
%APPDATA%\Code\User\（注意不是%USERPROFILE%\.vscode） - macOS：
~/Library/Application Support/Code/User/（不是~/Library/Preferences/Code） - Linux：
~/.config/Code/User/（不是~/.vscode）
必须完整备份以下内容：
-
settings.json和keybindings.json -
snippets/整个文件夹（含自定义 JSON 片段） -
extensions/文件夹本身——虽然体积大，但可避免某些扩展重装后反复报错（尤其含原生模块的插件，如ms-python.python）
仅导出扩展 ID 列表（code --list-extensions > extensions.txt）适合带宽受限场景，但恢复后首次启动仍可能卡在“正在激活扩展”。
code --install-extension 恢复失败的常见原因
执行 cat extensions.txt | xargs -I {} code --install-extension {} 报错或静默失败，通常因为：
-
code命令未加入 PATH：先在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用 - 扩展 ID 错误或已下架：部分扩展改名（如旧版
dbaeumer.vscode-eslint已迁移到eslint.vscode-eslint），需手动校验列表 - 网络策略拦截：企业内网可能屏蔽 Marketplace 请求，此时需提前下载
.vsix文件，用code --install-extension path/to/extension.vsix离线安装 - 版本不兼容：扩展声明支持的 VSCode 最低版本高于当前环境，命令行不会提示，但扩展面板里显示“已禁用”
恢复顺序不对，会导致设置被覆盖
重装系统或换电脑后，别一打开 VSCode 就开始操作。正确顺序是：
- 先退出所有 VSCode 实例
- 安装最新版 VSCode，但不要打开任何窗口
- 执行手动恢复：把备份的
User/文件夹完整覆盖到对应路径（覆盖前可重命名原User/作保留） - 再启动 VSCode，登录 Settings Sync —— 此时它会检测到本地已有配置，优先以本地为准，再增量同步云端差异
如果反过来先登录 Sync，再覆盖 User/，VSCode 可能触发双向冲突，部分设置被回滚，尤其是 keybindings.json 里自定义的快捷键容易丢失。
