Settings Sync插件是当前唯一可靠方案，因VSCode官方Settings Sync功能已于2023年底弃用；需手动登录GitHub授权gist等三项权限、启用扩展同步开关并首次上传配置，否则新设备无法下载。
Settings Sync插件现在是唯一可靠方案
VSCode 官方 Settings Sync 功能已在 2023 年底正式弃用，当前所有稳定同步行为都依赖 Settings Sync 扩展（作者 Shan Khan）。它不走 VSCode 内置账号体系，而是直连 GitHub Gist 存储配置快照——这意味着你必须手动登录、手动上传、手动下载，没有后台自动同步。
安装后必须做三件事才能让插件真正工作
装完扩展只是第一步，以下操作缺一不可：
- 运行
Sync: Login，跳转 GitHub 授权页时务必勾选gist、user:email、read:user三项权限（漏掉任一都会后续报错） - 运行
Sync: Advanced Options → Toggle Extension Sync，确保插件同步开关为启用状态（默认是关的） - 首次使用必须手动运行
Sync: Upload Settings，否则 Gist 里空空如也，新设备下载不到任何东西
同步失败最常见的四个静默原因
插件不会报错，但会跳过内容并假装成功。常见失效点包括：
-
settings.json中含绝对路径的字段（如python.defaultInterpreterPath、terminal.integrated.profiles.windows）会被直接过滤，且不提示 - 敏感字段如
http.proxy、telemetry.enableTelemetry默认不同步，即使你写了也不会上传 - 工作区级配置（
.vscode/settings.json）天然被排除，这是设计使然，不是 bug - JSON 文件里写了注释（
//）或不可见 Unicode 字符，会导致上传失败且控制台只显示Failed to sync: Unexpected end of JSON input
每次改配置后都要手动上传，别信“自动”
修改 keybindings.json、装/卸插件、更新代码片段后，Synced 状态栏图标不会变——它只表示上一次动作完成，不代表当前一致。必须主动运行：
-
Sync: Upload Settings（在原设备上） -
Sync: Download Settings（在目标设备上） - 若插件卡在
Installing...，打开扩展面板点右上角刷新按钮，否则不会真正安装
最常被忽略的是：GitHub Gist 里的 extensions.json 只存 ID 列表，不包含二进制文件；平台限定插件（如仅 Windows 的串口工具）在 macOS 上会被静默跳过，连日志都不打。
