VS Code Remote SSH 连接后配置远端专属设置

连接到远端主机后，VS Code 默认会继续沿用一部分本机 User 设置，但并不是所有参数都适合每台服务器。比较稳妥的做法是把 SSH 超时、远端终端或扩展行为写到 Remote 作用域。这样设置只跟当前主机走，Workspace 设置仍可在项目层覆盖它。

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

打开远端设置并锁定作用域

先确认 VS Code 左下角已经显示远端连接状态。若状态栏仍是本地窗口，后面打开的设置就可能写入 User 作用域，重连远端时自然看不到。确认连接后按下面的路径操作：

1. 按 F1 或 Ctrl+Shift+P 打开命令面板。
2. 输入 Preferences: Open Remote Settings，选择它进入远端设置页。
3. 如果习惯使用图形设置，也可以打开 Settings，在顶部作用域切换处选择 Remote。

页面切换成功的标志是搜索框和设置项都处在 Remote 作用域，而不是 User 或 Workspace。Remote-SSH 官方文档把这个入口用于当前 SSH 主机的专属设置。

按任务写入远端专属参数

进入 Remote 作用域后，搜索框可以直接筛选参数。常见做法是为网络距离较大的主机适当调整连接超时，或把某个远端环境需要的扩展加入默认安装列表。设置编辑器适合初次操作；需要复用或审阅时，可以打开 Remote Settings (JSON)。下面是可读性更好的 JSONC 示例，注释说明了每个字段的用途：

{
  // 只延长当前 SSH 主机的连接等待时间，单位为秒
  "remote.SSH.connectTimeout": 45,
  // 让指定扩展在这个远端主机首次连接时准备好
  "remote.SSH.defaultExtensions": [
    "golang.go"
  ]
}

不要把所有配置都搬到 Remote。主题、字体和快捷键通常属于本机体验；项目格式化规则、调试参数更适合 Workspace。配置项右侧如果显示 Remote，说明当前修改已经落在主机层。

用作用域和重连结果完成验收

1. 在命令面板分别打开 Preferences: Open User Settings (JSON)、Preferences: Open Remote Settings (JSON) 和 Preferences: Open Workspace Settings (JSON)。
2. 确认远端参数只出现在 Remote 文件中；如果同名设置在 Workspace 中存在，实际生效值以 Workspace 为准。
3. 执行 Developer: Reload Window，必要时选择 Remote-SSH: Kill VS Code Server on Host 后重新连接，观察设置是否仍然存在。

验证时看三处：左下角仍显示目标主机，设置项的作用域标记为 Remote，重连后参数值没有回退。只要本机窗口和另一台 SSH 主机不受影响，就说明隔离达成。

两个容易混淆的边界

看不到 Remote 选项：通常是当前窗口尚未连上 SSH 主机，先从 Remote Explorer 或命令面板重新连接，再打开设置。

改了却没有效果：先检查是否有 Workspace 同名值覆盖 Remote；再检查参数究竟由本地扩展还是远端扩展读取。Remote-SSH 连接后，许多扩展会安装到 SSH 主机端，位置不同也会影响配置生效范围。

常见问题

Remote 设置会同步到所有 SSH 主机吗？不会，它针对当前远端主机；需要共享时，应把稳定的项目规则放到 Workspace 或团队配置中。

为什么重连后仍有 User 设置？User 是基础层，会继续参与合并。只有当 Remote 或 Workspace 定义了同名键时，覆盖关系才会体现出来。

记住一条判断：主机差异放 Remote，项目差异放 Workspace，个人界面偏好放 User。连接状态、作用域标记和重连结果三项同时正确，远端专属设置才算真正完成。