vscode 内置 settings sync 可实现多端配置同步，需用 github 或 microsoft 账户登录并勾选 settings、extensions、keybindings、snippets 四项；它过滤敏感及平台相关设置，不支持 json 注释，扩展仅同步 id 列表；git 备份仍不可替代。
直接用 VSCode 内置的 Settings Sync 就能完成多端同步，不需要额外插件、不用手动复制文件——但前提是得选对登录方式、勾对同步项，否则会漏掉扩展或快捷键，甚至根本不同步。
怎么开启 Settings Sync 并确保它真在工作
VSCode 1.65+ 版本已原生集成该功能，不是插件，也不是“可能同步”，而是明确控制哪些内容上传/下载。关键动作是：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Turn on Settings Sync，然后必须选择 GitHub 或 Microsoft 账户登录（二者任一即可，GitHub 更稳定）。登录后弹出的「Choose what to sync」面板里，至少勾选这四项：Settings、Extensions、Keybindings、Snippets。UI State 可选，但勾上能还原侧边栏展开状态等细节。
常见错误现象：
- 点完“确定”后左下角没出现
Synced提示 → 检查网络是否拦截了vscode-sync.trafficmanager.net（企业环境常见），换 Microsoft 账户通常可绕过 - 新设备登录后扩展没装 → 确认原设备已成功上传（状态栏显示“Last synced”时间戳），且新设备未勾选“Download and merge”而误选了“Download and replace”导致跳过安装
为什么 settings.json 里的某些配置没同步过去
Settings Sync 不是无差别上传整个 settings.json 文件，它会过滤掉含敏感信息或平台强依赖的字段。例如：http.proxy、files.associations 中带绝对路径的值、prettier.configPath（除非对应扩展声明支持同步）都会被跳过。VSCode 还默认排除所有以 sync. 开头的设置项（如 sync.autoDownload），因为它们本身是用来控制同步行为的。
如果你发现某个自定义设置没生效，先检查它是否出现在 settings.json 中，再打开开发者工具（Developer: Toggle Developer Tools），看 Console 是否报错 Failed to sync: Unexpected end of JSON input——大概率是 settings.json 里写了注释（JSON 不支持）或混入了不可见 Unicode 字符。
扩展列表同步了，但插件没自动安装
Settings Sync 同步的是“已安装扩展的 ID 列表”，不是插件二进制文件本身。所以新设备首次下载后，VSCode 会尝试从 Marketplace 自动安装这些扩展。但以下情况会导致失败：
- 扩展在目标平台不可用（如 Windows-only 的终端增强插件，在 macOS 上不会安装）
- 扩展已被作者下架或重命名，ID 失效
- 网络无法访问
marketplace.visualstudio.com（国内常见），此时需手动安装或换源
验证方式：打开命令面板运行 Extensions: Show Installed Extensions，对比 ID 列表是否与原设备一致；若 ID 存在但状态为“Disabled”，说明安装失败，需点击启用或重试。
同步之外，真正可靠的备份还得靠 Git
云端同步解决的是“快速复现”，不是“可审计、可回滚、可共享”。比如你改错一个缩进设置想退回上周版本，Settings Sync 不提供历史记录；又或者团队要统一前端开发配置，它也不支持分支协作。这时候就得手动管理 settings.json、keybindings.json 和 snippets/ 目录。
操作要点：
- 不要直接在
~/.vscode/（Linux/macOS）或%APPDATA%\Code\User\（Windows）里初始化 Git 仓库——容易误提交缓存或敏感 token - 新建独立目录（如
~/dotfiles/vscode-user），只放需要版本化的文件，用符号链接指向真实位置 -
settings.json里避免硬编码绝对路径（如"python.defaultInterpreter"），改用${env:HOME}或环境变量
最易被忽略的一点：同步和 Git 是互补关系，不是替代关系。很多人开了 Settings Sync 就以为万事大吉，结果某天 GitHub 账号异常，或误点了“Reset Sync”，本地配置又没 Git 备份，只能重头来。
