必须用 GitHub 账户才能稳定使用 VSCode Settings Sync,因其是默认且最可靠路径;Microsoft 账户需 v1.90+ 且易受网络、证书、密钥协商失败影响,常静默失效。

必须用 GitHub 账户或 Microsoft 账户,但两者行为不同、权限路径不互通——选错账号会导致同步失败、插件不拉取、快捷键丢失,且错误现象往往不报错,只“静默失效”。
GitHub 账户是 Settings Sync 的默认且最稳定路径
VSCode 内置的 Settings Sync 功能在 1.75+ 版本中默认走 GitHub OAuth 流程,即使你用 Microsoft 账户登录了 VSCode 主体,同步后台仍会尝试调用 GitHub gist API。常见卡点包括:
- 点击
Preferences: Turn on Settings Sync…后跳转空白页或反复重定向 - 状态栏云朵图标始终灰色,
Sync Now不响应 - Extensions 和
Keybindings明明勾选了,新设备上仍为空
根本原因是:授权时没勾选 gist 权限,或 GitHub Personal Access Token 已过期。检查路径:Settings → Developer settings → Personal access tokens,确认 token 存在且含 gist、user:email、read:user 三项。
Microsoft 账户同步需 ≥ v1.90 且依赖端到端加密密钥协商
该路径数据不存 GitHub,而是加密后上传微软服务器,理论上更私密,但实际落地更脆弱:
- 旧版 VSCode(如 v1.85)调用
Preferences: Sync Now会直接无响应,不提示版本不足 - 企业网络若拦截
vscode-sync.trafficmanager.net或证书校验失败,同步状态栏显示Sync: On却从不上传/下载 - 首次启用时若本地
settings.json有语法错误(比如多了一个逗号),整个同步流程会静默跳过,不报错也不重试
验证是否生效:打开开发者工具(Developer: Toggle Developer Tools),切到 Console 标签页,输入 localStorage.getItem('syncMachineId') —— 若返回 null,说明密钥协商失败,同步未真正建立。
别信“自动同步”,所有更改都得手动触发上传
改完 settings.json、装了新扩展、重绑了 Ctrl+Shift+P,VSCode 不会自动推送到云端。你必须显式执行:
-
Preferences: Sync: Upload Settings(上传本地最新状态) -
Preferences: Sync: Download Settings(拉取其他设备的更新) - 状态栏右下角点击云朵图标 →
Sync Now(等价于先 Download 再 Upload)
容易忽略的坑:UI State(侧边栏折叠状态、编辑器分组布局)默认参与同步,但如果你在一台设备上频繁开关面板,另一台设备可能因布局冲突导致 workbench.layoutControl.enabled 被意外覆盖,表现为菜单栏突然消失或资源管理器无法展开。
敏感配置和工作区设置天然不上传,别指望它们漫游
以下内容无论你勾选多少次同步项,都不会上传到云端:
-
.vscode/settings.json(工作区级设置) -
.vscode/tasks.json和.vscode/launch.json -
terminal.integrated.shell.windows这类含绝对路径的配置 - SSH 配置、自定义字体路径、本地数据库连接串等
它们被设计为“设备绑定”,强行复制粘贴到另一台设备大概率报错或失效。真要跨设备复用,得靠 Git 管理工作区配置,或用 code --export-extensions + code --install-extension 单独处理扩展列表。











