VS Code Settings Sync 在远程窗口为什么不同步扩展

如果你发现本地 VS Code 已经通过 Settings Sync 同步了扩展，但打开 SSH、Dev Container 或 WSL 远程窗口后，远程侧仍然没有同一个扩展，这通常不是同步失败，而是产品边界本来就这样设计：Settings Sync 不会把扩展同步到远程窗口。远程窗口中的扩展需要安装到对应的远程扩展主机。

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

先把“本地 VS Code 实例之间的配置同步”和“远程窗口里的扩展安装”分开处理：Settings Sync 负责本地同步，SSH、Dev Container、WSL 窗口负责各自的远程安装。

先看 Extensions 视图：扩展到底装在哪里

连接远程窗口后，打开左侧的 Extensions 视图。远程开发场景下，扩展通常会按运行位置分组：一组是 Local - Installed，另一组是当前远程主机、容器或 WSL 环境。影响编辑器界面的主题、图标或部分 UI 能力，可能只需要留在本地；需要访问远程文件、远程语言工具链或远程运行时的扩展，则通常要安装到远程侧。

这里最有用的判断不是扩展名称，而是它所在的分组。看到扩展出现在 Local - Installed，只能说明本地 VS Code 有它；不能推出当前远程窗口也能使用它。

为什么 Settings Sync 不会替你安装远程扩展

Settings Sync 的扩展同步对象是各个本地 VS Code 安装中的扩展列表和全局启用状态。远程开发时，窗口虽然由本地界面呈现，但扩展可能运行在 SSH 主机、容器或 WSL 中。远程环境有自己的文件系统、操作系统、架构和依赖条件，不能简单把本地安装记录当成远程安装结果。

VS Code 官方文档明确说明，Settings Sync 不会同步到或从远程窗口同步扩展。因此，反复关闭再打开同步、重新登录账号，通常不会改变远程分组中的安装状态。真正需要做的是在当前远程窗口执行一次远程安装。

还要注意三个概念不要混在一起：

在 SSH、Dev Container 或 WSL 窗口单独安装

1. 先连接目标远程窗口。使用 Remote - SSH、Dev Containers 或 WSL 打开项目，确认左下角远程指示器已经显示当前目标。不要在普通本地窗口里点击安装后，就把它当成远程安装完成。
2. 打开 Extensions 并定位远程分组。在搜索框中输入扩展名，观察扩展卡片下方出现的安装位置。需要远程运行的扩展，通常会显示针对当前远程主机的安装按钮。
3. 执行对应的远程安装动作。在扩展详情或远程分组中选择 Install in SSH: remote-host、Install in Dev Container 或 WSL 对应的安装动作。具体按钮文字会随远程类型变化，但目标都是把扩展放进远程扩展主机。
4. 等待扩展主机完成安装。安装过程需要远程环境能够获取扩展包；如果远程网络、代理或权限不满足，按钮可能继续显示安装，或者安装后无法启用。此时应处理远程环境本身，而不是反复操作 Settings Sync。

怎样确认扩展已经在远程侧生效

安装后不要只看本地列表。按下面三个可见状态核对：

1. 扩展卡片出现在当前远程主机、容器或 WSL 的分组中，而不只是 Local - Installed。
2. 扩展详情页的操作按钮变成禁用、卸载或禁用等已安装后的状态，具体文案以当前远程类型为准。
3. 重新打开一个远程工作区，扩展提供的命令、语言服务或远程功能可以在这个窗口中出现；如果只在本地窗口出现，优先检查安装位置。

这一步的重点是“当前窗口是否能使用”，不是 Settings Sync 页面里的扩展列表是否发生变化。Settings Sync 页面可以继续作为本地配置的管理入口，但远程安装状态要回到 Extensions 视图核对。

多个 SSH 主机怎样减少重复安装

如果每次连接 SSH 主机都需要安装同一组扩展，可以使用 Remote - SSH 提供的默认扩展配置。它适合 SSH 主机的批量默认安装，但它仍然属于远程安装配置，不会改变 Settings Sync 的同步边界。

在用户设置中增加 remote.SSH.defaultExtensions，数组里的每一项写扩展 ID：

{
  "remote.SSH.defaultExtensions": [
    "golang.go",
    "ms-azuretools.vscode-docker"
  ]
}

上面的 JSON 必须保持合法格式，不能在对象内部添加注释。remote.SSH.defaultExtensions 的作用是告诉 Remote - SSH 连接时优先安装哪些扩展；它不负责 Dev Container 或 WSL，也不等价于 Settings Sync 的全局扩展同步。

遇到“装了但不能用”时先查远程环境

如果扩展已经出现在远程分组，但功能仍不可用，可以按这个顺序缩小范围：

• 确认当前打开的窗口仍然是目标 SSH、容器或 WSL 环境，而不是切回了本地窗口。
• 确认扩展没有在当前远程分组中被禁用，并检查它要求的运行时或工具链是否安装在远程环境。
• 如果扩展需要访问网络，检查远程环境自己的代理和出站访问；本地代理配置不一定能直接用于远程扩展主机。
• 如果远程安装失败，保留远程类型、扩展 ID 和安装提示，再处理权限、网络或架构兼容性。

最后记住这条判断规则

Settings Sync 能同步的是本地 VS Code 实例之间选择的数据；远程窗口里的扩展安装属于另一个运行位置。看到扩展没有出现在 SSH、Dev Container 或 WSL 分组时，不要把它当作同步故障，直接连接目标环境并在远程分组执行安装，再用当前窗口的功能状态完成验收。

相关问题

Settings Sync 开启了，为什么远程扩展还是空的？

这是远程窗口扩展不同步的预期行为。Settings Sync 不会把扩展同步到或从 SSH、Dev Container、WSL 等远程窗口同步，需要在对应远程环境单独安装。

所有扩展都必须安装到远程吗？

不一定。是否需要远程安装取决于扩展的运行位置和功能。影响本地 UI 的扩展可能留在本地，需要读取远程代码或调用远程工具链的扩展通常要放在远程侧。

remote.SSH.defaultExtensions 能替代 Settings Sync 吗？

不能。它针对 Remote - SSH 连接时的默认扩展安装，Settings Sync 则管理本地实例之间的同步数据；两者解决的边界不同。

远程扩展安装失败应该重新登录同步账号吗？

通常不需要。先看远程主机、容器或 WSL 的网络、代理、权限和运行时条件；只有本地同步本身出现冲突或账号问题时，才回到 Settings Sync 页面处理。