VS Code Settings Sync 怎样查看当前同步的配置项

如果你想确认 VS Code 到底同步了哪些内容，不需要先翻本地配置目录。打开命令面板，运行 Settings Sync: Show Synced Data，就能查看远端备份；在同一视图里展开 Synced Machines 可以看同步设备，打开视图菜单则能切到本地同步活动和本地备份。

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

下面的操作只围绕“查看当前同步内容”展开，不把排除设置、排除扩展或冲突合并混进主流程。界面插图是根据官方操作路径制作的原创说明图，不是 VS Code 截图。

先确认 Settings Sync 正在工作

先观察 VS Code 窗口底部 Activity Bar 的 Accounts 入口，或者打开 Manage 菜单。如果菜单中显示 Settings Sync is On，说明当前设备已经启用同步；如果还没有启用，可以选择 Backup and Sync Settings...，再选择要同步的数据并完成 Microsoft 或 GitHub 登录。

这里的“当前同步配置项”不是单独的一张总表，而是按数据类别组织的视图。官方文档列出的常见类别包括 Settings、Keyboard Shortcuts、Snippets、Tasks、MCP Servers、UI State、Extensions、Profiles，以及 Prompts and Instructions。Workspace tasks 不在同步范围内，连接 SSH、开发容器或 WSL 的远程窗口也不会把扩展同步到远程窗口。

打开 Show Synced Data 查看远端内容

按下 Ctrl+Shift+P（macOS 为 ⇧⌘P）打开命令面板，输入并选择 Settings Sync: Show Synced Data。如果你更习惯菜单，也可以从 Settings Sync 视图进入相同入口。

进入后，先看左侧或主面板显示的类别名称，再点开需要确认的类别。这个动作适合回答两个问题：当前同步服务里是否已经有对应类别，以及你要恢复或比较的内容属于哪一类。不要把它当成当前工作区的完整 settings.json 预览；它展示的是同步服务保存的类别和备份入口。

从同步数据视图确认设备

在同一个 Settings Sync 视图中找到 Synced Machines，展开后即可看到正在同步数据的设备。VS Code 会根据操作系统以及 Stable 或 Insiders 构建给设备生成默认名称。

设备列表主要用于确认“哪些设备仍在同步”。如果某台设备名称不容易识别，可以使用该设备的操作菜单重命名；如果某台设备已经不再使用，也能从设备操作中远程关闭它的 Settings Sync。这个入口改变的是设备同步状态，不是删除某一类本地配置。

查看远端备份与本地备份

想看远端历史版本时，继续使用 Settings Sync: Show Synced Data。VS Code 会为每个数据类别保留最近 20 个远端版本。选择某个类别的版本，可以把它作为恢复或比较时的参考。

想看本机保存的同步活动，打开 Settings Sync 视图右上角的溢出菜单，进入 Views，再选择 Sync Activity (Local)。如果需要直接打开磁盘目录，可以运行 Settings Sync: Open Local Backups Folder；本地备份按数据类别组织，里面通常是带时间戳的 JSON 文件。

本地备份不是永久归档。官方说明中，本地备份会在 30 天后删除；远端备份则按类别保留最新 20 个版本。因此，准备长期保存时不要只依赖本地备份目录，也不要把某个旧 JSON 文件直接当作当前设备已经加载的配置。

遇到“看不到内容”时先分清三种情况

如果首次启用同步或离线修改后出现冲突，Settings Sync 会暂停，直到完成冲突处理。此时先回到同步视图确认冲突类别，再选择保留本地、保留远端或打开差异编辑器合并；不要用“看不到版本”来判断数据已经丢失。

操作完成后的确认清单

1. 命令面板能找到 Settings Sync: Show Synced Data，并能打开远端数据视图。
2. 远端视图中能定位到要查看的类别，例如 Settings、Keyboard Shortcuts 或 Profiles。
3. Synced Machines 中的设备名称与当前使用情况相符。
4. 需要查本地历史时，能从 Views > Sync Activity (Local) 进入，而不是继续翻远端列表。
5. 记住本地备份 30 天、远端按类别保留最近 20 个版本的差异。

这样查看时，远端同步数据、同步设备和本地备份三个层次就不会混在一起：前者回答“云端有什么”，设备列表回答“谁在同步”，本地活动回答“这台机器留下过哪些同步记录”。

相关问题

Settings Sync 会同步工作区任务吗？

不会。官方文档区分了用户级 Tasks 与 Workspace tasks；前者可以同步，后者不在这个同步范围内。

远端备份能保留多少个版本？

官方说明是每个数据类别保留最新 20 个远端版本，本地备份则会在 30 天后删除。

怎么查看本地备份文件？

在 Settings Sync 视图的 Views 菜单选择 Sync Activity (Local)，或运行 Settings Sync: Open Local Backups Folder 打开本地目录。