VS Code Settings Sync 怎样排除某个扩展

如果你只想让一台电脑保留某个 VS Code 扩展，而不希望它随着 Settings Sync 出现在其他设备，最稳妥的做法是把扩展加入 settingsSync.ignoredExtensions。你可以从 Extensions 视图的扩展操作菜单完成，也可以直接在用户设置 JSON 中维护扩展 ID。

官方地址：https://code.visualstudio.com/

对应文档：https://code.visualstudio.com/docs/configure/settings-sync

第1步：先打开 Settings Sync 的同步类别配置

先确认 VS Code 已经登录并打开内置 Settings Sync。点击左下角或标题栏中的 Manage 齿轮，进入 Settings Sync is On，再选择 Settings Sync: Configure...。如果你看到的是首次启用向导，就先完成登录和同步类别选择。

在配置视图里找到 Extensions。它代表已安装扩展以及全局启用状态的同步类别。本文只调整其中一个扩展，不需要关闭整个 Extensions 同步。

第2步：从 Extensions 视图排除指定扩展

按 ⇧⌘X（Windows、Linux 使用 Ctrl+Shift+X）打开 Extensions 视图，在搜索框中输入目标扩展名称。找到对应条目后，打开条目右侧的更多操作菜单，在扩展操作中选择 Add to Settings Sync: Ignored Extensions 或含义相同的“排除扩展同步”动作。

关键是确认你操作的是扩展条目本身，而不是整个 Extensions 同步类别。完成后再次打开该菜单，动作通常会变成移出忽略列表的反向操作；这就是界面上的成功信号。

第3步：需要精确控制时直接编辑 ignoredExtensions

如果菜单动作没有出现，或者你要一次维护多个扩展，可以打开命令面板，执行 Preferences: Open User Settings (JSON)。在用户设置对象中加入或合并下面的字段：

{
  "settingsSync.ignoredExtensions": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode"
  ]
}

这是严格 JSON，不能在对象中添加注释；字段含义放在代码块外说明。数组中的值是扩展市场使用的完整 ID，格式通常是 发布者.扩展名。如果已有同名字段，只编辑原数组，不要在同一个 JSON 对象里重复写两个字段。

保存后，重点观察两件事：文件没有出现 JSON 语法错误提示，扩展 ID 在设置编辑器中保持为字符串数组。不要把扩展的显示名称、版本号或本地安装路径写进这个字段。

第4步：等待同步并核对排除结果

回到 Manage > Settings Sync is On > Settings Sync: Configure...，确认 Extensions 仍然开启。随后等待状态栏或账户菜单中的同步状态回到空闲状态；若同步出现冲突，先在 Settings Sync 视图中处理冲突，再判断扩展是否被排除。

正确结果是：当前设备仍然可以使用这个扩展，但它不再被当作需要推送到其他设备的同步项。你可以在另一台设备上观察后续同步结果，但不要因此重复安装、卸载或关闭整个 Settings Sync。

第5步：处理远程窗口和误排除

如果你连接的是 SSH、Dev Container 或 WSL，扩展实际运行在远程环境中。VS Code 官方说明这类远程窗口不会把扩展同步到远程窗口，也不会从远程窗口同步回来；因此，先确认当前窗口右下角的远程标识，再决定是在本地用户设置还是远端环境中安装和配置。

误把扩展加入忽略列表时，有两种恢复方式：在该扩展的操作菜单中选择移出 Settings Sync 忽略列表，或者从 settingsSync.ignoredExtensions 数组中删除对应的完整 ID。删除后保存，再回到 Settings Sync: Configure... 等待下一次同步即可。

常见问题：为什么写了 ignoredExtensions 仍然看到扩展

排除后当前电脑上的扩展会消失吗？

不会。排除控制的是同步范围，不是本地安装状态；当前电脑仍可以继续启用和使用该扩展。

应该填写扩展名称还是扩展 ID？

填写扩展 ID。可以从扩展详情或扩展条目的复制标识中确认 publisher.extension 形式的值。

为什么 Settings Sync 配置里没有 Extensions？

先确认 Settings Sync 已启用，并且当前登录账户完成了同步设置。若仍有问题，打开 View > Output，切换到 Log (Settings Sync) 查看同步活动，而不是直接改动多个设备的配置。

最后的验收标准是：settingsSync.ignoredExtensions 中有目标扩展的完整 ID，当前设备上的扩展仍可用，Settings Sync 配置视图仍保持 Extensions 开启，并且你已经区分了本地窗口与远程窗口的扩展范围。