macOS上VS Code配置同步必须使用Shan Khan开发的Settings Sync插件配合GitHub Gist，因官方同步功能已于2023年底弃用；该插件直接读写用户私有Gist，安全可控，支持插件、设置、快捷键、代码片段等完整同步，但需手动启用扩展同步并注意路径、工作区及敏感字段不参与同步。
macos 上用 vs code 同步配置，现在必须靠 settings sync 扩展（作者 shan khan）配合 github gist，因为官方 settings sync 功能已在 2023 年底正式弃用，内置的“turn on settings sync”命令已失效，点开也没用。
这个扩展不走 VS Code 后端服务，而是直接读写你自己的私有 GitHub Gist，安全、可控、兼容性强，是目前 macOS 多机同步唯一稳定可靠的方案。
安装与首次配置
- 打开 VS Code，进入 Extensions 视图（Cmd+Shift+X），搜索并安装 Settings Sync（作者 Shan Khan）
- 安装后必须重启 VS Code，否则命令无法注册
- 按 Cmd+Shift+P，输入
Sync: Login，回车 - 跳转到 GitHub 授权页，务必只勾选
gist权限（不是 repo、user 或其他），否则后续上传/下载会失败 - 授权成功后，插件会提示是否上传本地设置，选 Yes，它会创建一个名为
cloudSettings的私有 Gist，并存入settings.json、keybindings.json、snippets/等文件
插件同步必须手动开启
默认情况下，扩展列表（extensions.json）只是快照，不会触发实际安装。要让插件也同步：
- Cmd+Shift+P → 输入
Sync: Advanced Options→ 选择Toggle Extension Sync，确认状态变为 enabled - 再次运行
Sync: Upload Settings，此时extensions.json才会包含真实插件 ID 列表 - 在另一台 Mac 上完成登录后，运行
Sync: Download Settings - 下载完成后，打开 Extensions 视图，点击右上角刷新按钮；或运行
Extensions: Install Extensions from VSIX，系统会批量安装缺失插件（大体积插件如 Python 扩展可能卡住，稍等即可）
哪些内容不能同步，需特别注意
- 全局
settings.json中含本地路径的字段（如"python.defaultInterpreterPath": "/Users/xxx/.pyenv/..."）会被跳过，否则跨设备导致崩溃 - 工作区设置（即项目内
.vscode/settings.json）不同步，这是设计使然，避免污染团队配置 - 敏感字段如
http.proxy、terminal.integrated.env.*、SSH 密钥路径等，不会写入 Gist，也不建议手动添加 - 键盘快捷键中绑定笔记本特殊功能键（如 F5/F6 控制音量）可能在另一台 Mac 上无效，属于平台差异，无法自动适配
日常维护建议
- 同步是覆盖式，没有合并逻辑。换电脑前，先
Sync: Download Settings拉最新版 - 修改设置或装新插件后，记得手动
Sync: Upload Settings，它不会自动上传 - 可给 Gist 加描述，比如
macbook-pro-2024-work，方便在 GitHub 上人工比对版本 - 如果某台 Mac 临时禁用了大量插件用于调试，上传前请确认是否真要推送到所有设备
不复杂但容易忽略。
