Settings Sync 默认关闭，需手动执行“Turn on Settings Sync…”并勾选同步项才能启用；GitHub 与 Microsoft 账户同步机制不同，前者存于私有 gist 可编辑，后者走微软服务不可干预；路径、代理等本地化设置应通过 settingsSync.ignoredSettings 排除。
Settings Sync 为什么在状态栏显示“Sync: Off”
VSCode 内置的 Settings Sync 功能默认是关闭的，哪怕你装了最新版（1.87+），也不会自动开启。它不依赖后台服务常驻，而是按需触发——登录账户只是授权，真正上传配置要手动点一次“Turn on Settings Sync…”。如果你看到状态栏右下角云朵图标是灰色、或命令面板搜 Preferences: Turn on Settings Sync... 没反应，大概率是没完成最后一步：选择同步项并确认上传。
常见错误现象：
- 登录 GitHub/Microsoft 账户后，状态栏仍无变化
- 执行
Preferences: Configure Sync...发现所有选项都是未勾选状态 - 换电脑登录同一账户，提示“无远程配置可下载”
解决方法很简单：
- 必须执行一次
Preferences: Turn on Settings Sync...（不是只登录） - 弹出窗口中务必勾选“Extensions”“Settings”“Keybindings”“Snippets”等核心项
- 点击“启用同步”后，VSCode 会立即上传当前本地配置——这是云端首次快照，后续设备才有的可拉取内容
GitHub 账户 vs Microsoft 账户同步差异
两者都能用，但行为和底层存储不同，选错容易踩坑。GitHub 方式把所有配置存为一个私有 gist（比如名为 cloudSettings 的 JSON 文件），你能直接在 https://www.php.cn/link/55360c0b34441c9aba384b54a7279ad6 上看到、编辑、甚至 git clone；Microsoft 方式走的是微软自有同步服务，不暴露原始数据，也不支持手动干预。
关键区别：
- GitHub 同步可被企业网络拦截（需放行
api.github.com和gist.github.com），Microsoft 方式在部分国内企业环境更稳定 - GitHub Token 权限只需
gist，无需其他 scope；Microsoft 登录需要user_impersonation和offline_access - 跨平台路径问题：Windows 和 macOS 共用 GitHub 账户时，
terminal.integrated.shell.windows这类设置会被同步过去，但在 Mac 上无效甚至报错——得加进settingsSync.ignoredSettings
哪些设置不该同步，怎么排除
不是所有 settings.json 里的字段都适合跨设备流转。像本地调试路径、代理地址、终端 shell、文件编码偏好这些，硬同步会导致另一台机器启动失败或功能异常。
推荐做法是用 settingsSync.ignoredSettings 显式屏蔽：
- 打开
settings.json（Ctrl+, → 右上角 {} 图标） - 添加字段：
"settingsSync.ignoredSettings": ["http.proxy", "terminal.integrated.shell.linux", "files.autoSave"] - 注意：数组里填的是设置项的完整 key 名，不是插件名或文件名
- 扩展也可单独忽略，例如：
"settingsSync.ignoredExtensions": ["ms-vscode.cpptools"]（避免 Windows C++ 工具链同步到 Mac）
工作区级配置（即项目内 .vscode/settings.json）默认完全不参与同步，这是设计使然，别试图用插件强行同步它——容易覆盖团队约定。
手动同步失败时该看哪几个地方
同步卡住、提示“conflict”但没弹窗、下载后插件没装上……这类问题通常不出在登录环节，而在于状态判断和本地缓存。
- 先运行
Preferences: Show Sync Status，看是否显示 “Up to date” 或 “There are conflicts” - 如果显示冲突，不要直接点“Resolve Conflicts”，先点
Sync: Show Summary查最近一次上传/下载时间戳，确认是不是真有新变更 - 插件没装上？检查
Developer: Show Running Extensions里vscode-sync是否在运行；若已禁用，手动启用再试 - 仍失败可重置：运行
Preferences: Reset Settings Sync...，但注意这会清空云端所有历史记录，仅保留最后一次上传的内容
最易被忽略的一点：同步不是实时双向监听。改完快捷键、装完插件后，必须手动触发一次 Sync: Upload，否则另一台电脑永远拉不到这次更新。
