VS Code Settings Sync 选择性同步工作区设置

VS Code 的 Settings Sync 可以选择同步“设置、快捷键、代码片段、任务、扩展、界面状态、配置文件”等类别，也能排除某个用户设置；但它不会把项目里的工作区设置当作个人设置上传。正确做法是：个人偏好交给 Settings Sync，项目专属值写入 Workspace 范围，设备相关的用户设置再加入忽略清单。

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

第一步：先确认哪些内容应该同步

打开 VS Code 后先把设置分成三类。第一类是个人通用偏好，例如主题、编辑器字号、快捷键和常用扩展，适合跨设备同步。第二类是设备相关值，例如本机字体、终端配置和本地可执行文件路径，通常应排除。第三类是项目约束，例如格式化规则、文件排除、语言版本和项目内工具参数，应放进工作区设置。

这里最容易误解的是“同步工作区设置”。Settings Sync 的 Settings 类别针对用户设置；Workspace Settings 由当前项目保存并覆盖用户设置。单文件夹工作区通常写入项目根目录的 .vscode/settings.json，多根工作区则写进 .code-workspace 文件。需要团队共享时，应随项目版本库管理，而不是依赖个人账号同步。

第二步：启用 Settings Sync 并选择类别

点击左下角活动栏底部的管理齿轮或账户图标，选择 Backup and Sync Settings...。在弹出的数据选择器中保留 Settings，再按需求选择 Keyboard Shortcuts、Snippets、Extensions、Profiles 等类别，随后点击 Sign in，使用 Microsoft 或 GitHub 账号完成登录。

登录完成后，左下角菜单会显示 Settings Sync is On。以后要修改范围，沿着 管理齿轮 → Settings Sync is On → Settings Sync: Configure... 再次打开选择器即可。若只想同步设置，不想把扩展列表带到另一台电脑，就取消 Extensions，不需要关闭整个同步功能。

第三步：排除不适合跨设备的用户设置

按 Ctrl+Shift+P（macOS 为 Shift+Command+P）打开命令面板，执行 Preferences: Open User Settings (JSON)。在用户配置中添加 settingsSync.ignoredSettings，数组里填写不希望上传的设置 ID。

{
  // 这些值只适合当前设备，不交给 Settings Sync
  "settingsSync.ignoredSettings": [
    "editor.fontFamily",
    "terminal.integrated.defaultProfile.windows"
  ]
}

保存后回到图形化设置页，搜索 Settings Sync: Ignored Settings，可以看到同一份列表。也可以在某个设置项右侧的齿轮菜单中使用该设置的同步操作，把它加入忽略范围。成功状态是：该设置仍在当前电脑生效，但不会继续覆盖其他设备上的对应用户值。

第四步：把项目专属值保存到 Workspace

按 Ctrl+,（macOS 为 Command+,）打开设置编辑器，切换顶部的 Workspace 标签页。搜索要修改的项目设置，例如 Files: Exclude 或 Editor: Format On Save，只在 Workspace 范围修改。此时 VS Code 会把值保存到当前项目，而不是用户配置。

如果习惯直接编辑文件，可在命令面板运行 Preferences: Open Workspace Settings (JSON)。下面示例把保存时格式化和文件排除固定为项目规则：

{
  // 团队项目统一在保存时格式化，不写入个人用户设置
  "editor.formatOnSave": true,
  // 只隐藏当前项目生成的目录
  "files.exclude": {
    "**/.cache": true,
    "**/dist": true
  }
}

保存后，设置项左侧会出现工作区已修改的标记，资源管理器中能看到 .vscode/settings.json。把这个文件提交到团队认可的版本库后，其他成员打开项目即可获得相同的项目设置；若某个设置涉及个人路径、凭据或只适合一台机器，就不要提交到工作区文件。

第五步：查看同步记录并验收

打开命令面板，执行 Settings Sync: Show Synced Data。在同步数据视图中检查 Settings、Extensions 等已启用类别以及设备列表。需要查看当前机器的本地记录时，在该视图右上角更多菜单中打开 Views → Sync Activity (Local)。

最后在另一台设备登录同一账号，确认通用主题或快捷键已经出现，而忽略清单中的字体、终端设置仍保持当地配置。再打开同一个项目，确认 Workspace 值覆盖用户值。出现首次合并冲突时，不要直接覆盖：选择 Show Conflicts 比较本地和远端内容，编辑合并结果后点击 Complete Merge。

常见问题

为什么另一台电脑没有出现项目的 Workspace 设置？

因为 Settings Sync 不负责上传项目工作区设置。请确认 .vscode/settings.json 或 .code-workspace 文件已经随项目复制或提交。

能不能只同步一个工作区的扩展？

Settings Sync 同步的是安装扩展和全局启用状态。项目推荐扩展可写入 .vscode/extensions.json，由使用者确认安装；它不是自动安装清单。

为什么 SSH、Dev Container 或 WSL 窗口没有同步扩展？

官方说明指出，Settings Sync 不会把扩展同步到远程窗口。远程环境中的扩展需要在对应环境单独安装。

怎样撤销同步但保留本地配置？

选择 Settings Sync is On → Settings Sync: Turn Off，确认仅关闭当前设备。除非确实要清空云端数据，否则不要勾选“在所有设备关闭并清除云端数据”。