排查VSCode插件在Remote-SSH连接下的卡顿问题-VSCode-PHP中文网

Remote-SSH插件响应延迟主因是remote.SSH.showLoginTerminal启用导致登录阻塞、插件未正确安装到远程端、files.watcherExclude未在远程settings.json中配置，以及Python/TypeScript路径未显式指定。

排查vscode插件在remote-ssh连接下的卡顿问题

Remote-SSH 连接后插件响应延迟明显，先看 `remote.SSH.showLoginTerminal` 是否启用

VSCode 在 Remote-SSH 模式下会把部分插件逻辑卸载到远程端执行，但若登录过程卡在终端等待交互（比如密钥密码、MFA 提示），整个插件初始化就会阻塞。默认该设置为 false，一旦设为 true，每次连接都会强制弹出登录终端——看似“更透明”，实则打断后台静默认证流程，导致 ms-vscode.vscode-typescript-next、esbenp.prettier-vscode 等依赖语言服务器的插件迟迟无法就绪。

解决办法很简单：打开 VSCode 设置（Ctrl+,），搜索 remote.SSH.showLoginTerminal，确保其值为 false；同时确认你的 SSH 配置已支持无密码登录（如 IdentityFile ~/.ssh/id_rsa + IdentitiesOnly yes）。

插件被重复安装在 remote 和 local 两端，引发 `Extension host terminated unexpectedly`

很多用户习惯在本地装完插件后直接连 Remote-SSH，结果发现某些插件（尤其是含 native 二进制依赖的，如 streetsidesoftware.code-spell-checker 或 ms-python.python）在 remote 端根本没激活，或者反复报 Extension host terminated unexpectedly。这是因为 VSCode 默认只同步「UI 层插件」（如主题、快捷键扩展），而语言支持、格式化、LSP 类插件必须显式安装到 remote 环境中。

连接 Remote-SSH 后，点击左下角绿色远程状态栏 → 选择 Install in SSH: [hostname]
不要依赖「Install on all platforms」或「Sync extensions」开关——它不保证 binary 兼容性
检查远程 ~/.vscode-server/extensions/ 目录下对应插件是否含 node_modules 且架构匹配（例如 ARM 服务器不能跑 x64 编译的 prettier 二进制）

`files.watcherExclude` 和 `search.exclude` 在 remote 端未生效，触发大量文件监听抖动

VSCode 的文件监听器（chokidar）在 remote 环境下走的是 SSHFS 或 remote agent 代理，一旦 node_modules、.git、dist/ 等目录未被正确排除，就会通过网络频繁轮询变更，造成编辑器假死、光标延迟、保存卡顿。关键是：这些设置必须写在 remote 端的 settings.json 里，而不是本地工作区或用户设置。

操作路径：连接 remote 后，打开命令面板（Ctrl+Shift+P）→ 输入 Preferences: Open Remote Settings (SSH: hostname) → 添加：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

{
  "files.watcherExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true,
    "**/.git/**": true
  },
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true
  }
}

注意：files.watcherExclude 是 glob 模式，不支持正则；且路径前缀无需加 /，否则在 remote 工作区下会失效。

Python / TypeScript 插件在 remote 初始化慢，本质是 `serverReadyAction` 超时或路径解析错误

比如 ms-python.python 卡在 “Starting Microsoft Python Language Server…” 或 ms-vscode.vscode-typescript-next 报 Could not find tsserver.js，往往不是性能问题，而是 remote 端的解释器/TypeScript SDK 路径没被正确识别。VSCode Remote 不会自动继承 shell 的 $PATH，尤其当使用 nvm、pyenv 或自定义 ~/.bashrc 时。

验证和修复步骤：

在 remote 终端中运行 which python3 和 which tsserver，记下绝对路径
在 remote settings 中显式配置："python.defaultInterpreterPath" 和 "typescript.preferences.includePackageJsonAutoImports" 等不关键，但 "typescript.tsdk" 必须指向含 tsserver.js 的目录（如 "/home/user/.nvm/versions/node/v18.18.2/lib/node_modules/typescript/lib"）
避免用 ~ 符号——remote agent 解析时可能不展开，一律用绝对路径