不支持。VSCode 1.84+ 官方 Settings Sync 已强制仅支持 Microsoft 账户,GitHub 登录会失败;如需 GitHub 同步,须安装第三方 Settings Sync 扩展(Shan Khan 维护),通过 GitHub Gist 手动同步配置。

VSCode 官方 Settings Sync 还支持 GitHub 账号吗?
不支持。自 VSCode 1.84 版本起(2023 年底开始逐步切换,2026 年已全面落地),官方 Settings Sync 后端已强制切换为 Microsoft 账户认证体系,GitHub 账号登录会失败或卡在 Signing in… 状态。
如果你在命令面板里输入 Preferences: Turn on Settings Sync 后选 GitHub,页面可能跳转但无响应;或者授权后提示 Failed to sync: Bad credentials —— 这不是 token 配置问题,而是服务端已拒收 GitHub 凭据。
必须满足三个条件才能启用官方同步:
- VSCode 版本 ≥ 1.84(检查方式:
Help → About) - 使用 Microsoft 账户(
@outlook.com、@hotmail.com或企业 Azure AD 账户)登录 - 手动执行
Preferences: Turn on Settings Sync,不能仅靠左下角用户图标点开
那还能用 GitHub 同步吗?得靠 Settings Sync 扩展
可以,但不再是官方功能,而是由第三方扩展 Settings Sync(作者 Shan Khan)提供支持。它不走 VSCode 内置通道,而是直连 GitHub Gist 存储配置,目前仍是 GitHub 路径下最稳定的选择。
关键事实:
- 安装后需手动触发
Sync: Login,跳转 GitHub 授权页时必须勾选gist权限(不是repo) - 默认不同步插件列表,必须运行
Sync: Advanced Options → Toggle Extension Sync开启 - 本地工作区设置(
.vscode/settings.json)永远不上传,这是设计行为,不是 bug - 敏感字段如
http://、含token或password的配置项会被自动过滤,不会写入 Gist
同步后插件没装上?先看这几个地方
常见现象:Settings Sync 扩展显示“Upload success”,但另一台电脑运行 Sync: Download 后,插件列表为空,或只装了一半。
原因和应对:
-
Sync: Show Output里出现Extension sync disabled→ 检查是否执行过Toggle Extension Sync - 某台电脑的
extensions.autoUpdate设为false→ 同步后插件 ID 已写入,但不会自动下载安装,需手动运行Extensions: Install Extensions from Sync - 扩展本身不兼容当前平台(比如 Windows 专用插件同步到 macOS)→ VSCode 不报错,但插件状态显示“Disabled”,需人工剔除或换平台适配版
- Gist 被意外清空或权限变更 → 登录 https://www.php.cn/link/55360c0b34441c9aba384b54a7279ad6 查看是否存在名为
vscode-sync的私有 Gist
多台电脑同时改配置,会覆盖还是合并?
没有合并逻辑,纯覆盖。谁最后 Sync: Upload,谁的内容就生效——这是 Gist 存储模型决定的,不是插件缺陷。
实操建议:
- 换电脑前,务必先运行
Sync: Download拉取最新版,再开始改设置 - 如果某台设备做了大量临时调试改动(比如禁用 10 个插件),上传前确认是否真要推送到所有设备
- 给 Gist 加描述,例如
macbook-pro-2024-q2或desktop-win11-work,方便在 GitHub 上人工比对版本差异 - 不要依赖“自动同步”:该扩展默认关闭自动上传/下载,每次修改后都得手动触发,否则另一台设备永远看不到变化
真正容易被忽略的,是路径和平台差异带来的隐性冲突——比如你在 Windows 上配置了 terminal.integrated.profiles.windows,同步到 macOS 后这个字段会被保留但完全无效,还可能干扰终端初始化。这类问题不会报错,只能靠你记得自己删。


















