不能用了。官方插件 Settings Sync 已于 2023 年底下架,仓库归档、服务停运,所有同步操作均失败;应改用 VSCode 内置的 Settings Sync(GitHub 登录),支持设置、扩展、快捷键等双向同步,需妥善保管本地加密密钥。

Settings Sync 插件还能用吗?
不能用了。官方插件 Settings Sync(作者 Shan Khan)已于 2023 年底正式下架,VSCode 商店已移除,GitHub 仓库归档,且不再接收 PR 或修复问题。所有依赖它的同步流程现在都会失败——比如登录后提示 Unauthorized,或执行 Sync: Upload Settings 时卡在“Fetching GitHub token”。这不是配置错误,是服务端已停运。
替代方案:用 VSCode 内置的 Settings Sync(GitHub 登录)
VSCode 自 1.68 版本起内置了同名功能(Settings Sync),但和旧插件完全无关,由微软直接维护,使用 GitHub 账号 OAuth 授权,同步内容包括设置、快捷键、扩展、代码片段、UI 状态(如侧边栏展开状态)等。
- 启用方式:Ctrl+Shift+P → 输入
Preferences: Turn On Settings Sync→ 选择账户(必须是 GitHub)→ 勾选要同步的项(建议全选) - 首次上传会生成一个加密密钥(
sync encryption key),它不存于 GitHub,只本地保存;换新设备首次拉取时需手动输入该密钥,否则解密失败 - 不同设备登录同一 GitHub 账号后,只要密钥一致,就能双向同步;密钥丢失 = 同步数据不可恢复(不是删除,是彻底无法解密)
- 扩展同步依赖
extensionId而非名称,所以即使某扩展改名或下架,只要 ID 不变,仍能正确还原
常见同步失败场景和排查点
同步失败通常不报错,而是静默跳过某些项。重点检查以下几处:
-
settings.json中手动添加的字段若与同步内容冲突(例如同时启用了同步的editor.fontSize和本地硬编码的同名设置),以同步值为准,本地覆盖会被忽略 - 扩展未同步成功?检查该扩展是否支持同步:打开扩展详情页,看是否有
supportsSettingsSync字段(多数主流扩展都支持,但部分旧版或小众扩展不声明,就会跳过) - 同步延迟明显?不是实时的,通常在退出 VSCode 或手动触发
Sync: Trigger Auto Sync后才发生;网络请求走的是https://vscode-sync.trafficmanager.net,国内偶尔受 DNS 或代理影响,可临时切到系统代理重试 - 误删了密钥?可通过
Sync: Show Synced Data查看当前同步状态,但无法导出密钥;唯一补救方式是关闭同步 → 清空~/.vscode/argv.json中的 sync 相关字段 → 重新开启并生成新密钥(代价是丢弃历史同步记录)
为什么不要自己用 Git 手动管理 settings.json?
有人把 settings.json、keybindings.json 提交到私有仓库,看似可控,实际埋雷:
- 路径类设置(如
files.exclude、python.defaultInterpreterPath)在不同机器上绝对路径必然不同,每次拉取都要手动改,极易出错 - 扩展版本号不会被记录,
extensions.json只存 ID,Git 无法保证两台机器装的是同一版扩展,可能引发兼容问题 - UI 状态(如已打开的文件、编辑器布局)完全无法 Git 化,而内置 Settings Sync 能同步这部分,体验更完整
- 多设备频繁切换时,Git merge 冲突概率高,尤其是多人共用账号或误操作提交了本地调试配置
内置 Settings Sync 的密钥管理和增量同步逻辑已经足够健壮,手动 Git 方案只适合极简配置或离线环境,日常多机同步没必要绕路。


















