VS Code Settings Sync区分同步设置与同步扩展的实现方法

换电脑后，VS Code 最容易出现的误判是“设置回来了，扩展却没回来”。Settings Sync 确实能同步设置、快捷键、代码片段、任务、界面状态、扩展和 Profiles，但这些项目是可配置的，远程窗口的扩展还有单独边界。先把同步设置和同步扩展拆开检查，迁移时就不会只看一个“已开启”状态。

官方地址：https://code.visualstudio.com/docs/configure/settings-sync

步骤一：从 Manage 打开 Settings Sync

打开 VS Code 后，点击左下角 Manage（齿轮或当前配置入口），选择 Backup and Sync Settings...。如果底部没有明显入口，也可以从 Activity Bar 底部的账户入口进入同一设置流程。首次开启时选择登录方式，当前官方文档列出的账户类型是 Microsoft 或 GitHub。

登录完成后，Settings Sync 会在后台继续同步偏好。此处先确认两件事：左下角菜单已经显示同步开启状态；再次打开菜单时能找到 Settings Sync: Configure。这说明服务已进入可配置状态，但还不能说明所有扩展都已经同步。

步骤二：区分设置类数据与扩展类数据

在 Manage 菜单选择 Settings Sync: Configure，逐项查看同步清单。常见项目包括 Settings、Keyboard Shortcuts、User Snippets、User Tasks、UI State、Extensions 和 Profiles。

判断范围时不要只问“同步有没有开”，而要问“这一项是否被选中”。Settings 负责编辑器偏好，Extensions 负责内置及已安装扩展及其全局启用状态；快捷键默认按平台区分，跨平台使用时还要留意 settingsSync.keybindingsPerPlatform。一个范围没有勾选，不代表另一个范围也被关闭。

步骤三：用 ignoredSettings 和 ignoredExtensions 收窄范围

如果某些设置只适合当前电脑，打开设置编辑器搜索 settingsSync.ignoredSettings；如果某个扩展不想跟着账户到每台设备，搜索 settingsSync.ignoredExtensions。把目标设置键或扩展标识加入对应列表，再回到 Settings Sync: Configure 复核。

这一步的价值在于保留“整体同步”，同时把机器差异留在本地。例如显示器、代理、特定平台快捷键或只服务于一台机器的扩展，不必因为同步开启就全部复制。不要直接修改同步服务的内部文件；用设置编辑器维护忽略项，后续更容易迁移和回退。

步骤四：在新机器和远程窗口验收同步结果

在新机器登录同一账户，打开 Settings Sync: Show Synced Data 查看当前同步数据，再检查本地 Settings、快捷键和 Extensions 视图。若需要找回旧版本，可以打开 Settings Sync 的本地或远程备份视图；本地备份按资源类型保存，远程备份保留每项资源的最近版本。

验收时把本地窗口和远程窗口分成两张清单。官方文档明确说明，连接到 SSH、Dev Container 或 WSL 的远程窗口时，扩展不会从远程窗口按同样方式同步。因此本地扩展都出现，只能证明本地环境恢复正常；远程开发还要在对应窗口单独安装并启用所需扩展。若出现冲突，再选择 Accept Local、Accept Remote 或 Show Conflicts，不要用“重新开关同步”替代判断。

常见问题

Settings Sync 开启后，扩展为什么没有全部出现？

先在 Configure 中确认 Extensions 被选中，再检查是否加入了 ignoredExtensions。若问题发生在 SSH、Dev Container 或 WSL 窗口，还要单独安装远程扩展。

Settings 和 Extensions 能不能只同步一个？

可以。Settings Sync 的配置清单按资源类型选择，设置与扩展是独立范围，按迁移目标勾选即可。

为什么同一套快捷键换平台后表现不同？

快捷键默认按平台同步。需要跨平台复用时，检查 settingsSync.keybindingsPerPlatform 是否关闭，并重新核对冲突快捷键。

同步冲突应该选本地还是远程？

以最后一次确认过的配置为准：保留当前机器选 Accept Local，采用云端选 Accept Remote，不确定时先用 Show Conflicts 对比后再处理。