VS Code Remote SSH 怎样保留远端扩展范围

VS Code Remote SSH 的远端扩展范围，应通过当前连接的主机、扩展安装分组和运行位置共同确认。需要处理远端项目的扩展安装到对应 SSH 主机；界面类扩展按其设计留在本地。不要把本地“已安装”当成远端已经可用，也不必把所有本地扩展批量装到每台主机。

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

下面假定已安装 Remote - SSH，并且已经有一台可正常连接的授权主机。示例别名 dev-lab 只是教学名称，不是可直接访问的地址。本文只处理扩展作用域，不修改 SSH 凭据、服务器配置或现有项目文件。操作前写下需要的扩展名称与发布者，避免把同名第三方项装错。

步骤1：确认正在目标 SSH 窗口中

入口：打开命令面板，macOS 使用 Shift+Command+P，Windows/Linux 使用 Ctrl+Shift+P，运行 Remote-SSH: Connect to Host...，选择自己已有的授权主机。

动作：连接完成后先停在该窗口，查看左下状态栏中的 SSH 主机标识。目标是确认正在 dev-lab 对应的远程窗口，而不是旁边另一个本地窗口。若仍显示连接中或报错，先处理连接问题，不要以此时的扩展列表判断远端安装状态。

继续条件：状态栏显示预期主机。后面所有扩展操作都在这个窗口进行；多台机器并行使用时，每次切换窗口都重新看一眼主机名称。

步骤2：只把需要的扩展安装到远端

入口：在当前远程窗口打开扩展视图，macOS 按 Shift+Command+X，Windows/Linux 按 Ctrl+Shift+X。先看 Local - Installed 与 SSH 主机对应分组，再查找自己项目需要的目标扩展。

动作：对确实需要在远端使用、且界面提供远端安装入口的扩展，选择其面向当前 SSH 主机的安装按钮。核对按钮中的主机名，再执行安装。若只有本地条目而远端尚未安装，不要反复按本地启用来代替远端安装。

继续条件：安装结束后，目标扩展可在该 SSH 主机分组中找到，界面不再显示安装进行中；若提示重新加载，先保存工作，再按提示完成。不应只看扩展总数量，因为数量相同也可能是不同扩展或不同主机。

VS Code 会根据扩展设计选择适当位置。没有远端安装按钮不一定是异常：影响界面的扩展可能本来就应留在本地。这里的“只安装需要的项”是管理选择，不保证扩展完全没有依赖；出现额外依赖时应先辨明来源，不自动批量卸载。

步骤3：区分已安装与正在运行的位置

入口：在同一个 SSH 窗口的命令面板运行 Developer: Show Running Extensions。

动作：在打开的运行扩展页面查找目标项，阅读本地或远端运行位置。安装列表与运行列表回答的是两个问题：一个说明安装在哪里，另一个说明当前已激活的扩展在哪里运行。若目标尚未列出，可先按该扩展正常用法打开适用文件或使用其功能，再观察；不应将“尚未激活”直接判为安装丢失。

继续条件：对需要且已经激活的目标项，能解释其运行位置，并与项目需要相符。若不符，先核对窗口、扩展文档与支持范围，而不是直接强制切换宿主。remote.extensionKind 属于高级干预，可能破坏扩展行为，不是日常保留范围的通用开关。

记录主机与扩展清单，保留各自范围

完成后保留一张自己的清单：主机别名、目标扩展 ID、安装分组、观察到的运行位置。无需收集服务器真实地址、私钥或完整项目路径。以后重连同一主机，先按这张清单查看；换了主机则重新确认，不把一台机器的结果套用到另一台。

若出现远端条目缺失，先核对是否连到了同一主机及同一使用环境，再决定是否补装。不要在不明原因时卸载整套扩展、复制扩展目录或改远端运行设置。保留范围的核心是知道“哪台主机需要哪一项”，不是让所有机器的列表看起来一致。

远程窗口里本地扩展变灰，是不是损坏了？

不一定。需要远端运行的本地项可能在当前远程上下文中不可用，应查看是否提供针对该主机的安装入口。

主题也必须装到远端吗？

不要一概而论。扩展位置由其用途和支持方式决定，界面类扩展与工作区类扩展不必采用相同位置。

安装成功为什么仍看不到运行项？

安装不等于已激活。先使用目标扩展适用的功能，再结合它的文档判断；运行位置正确也不等于所有外部依赖都已齐备。

说明依据：Remote - SSH 扩展管理、远程扩展运行位置。