remote-ssh 连接失败主因是系统 ssh 客户端缺失或配置错误、服务器 node 环境/权限不足、文件同步性能差、ssh-agent 未生效；需依次验证 ssh -v、node --version、~/.vscode-server 权限、files.exclude 配置及 ssh-add 状态。
Remote-SSH 插件装了但连不上 ssh 命令报错
VSCode 依赖系统级 ssh 客户端，不是自己带的。如果终端里运行 ssh user@host 都失败，Remote-SSH 肯定连不上。
常见错误现象：Failed to fetch remote environment、Could not establish connection 或弹窗提示 “The 'ssh' command was not found”。
- 先在本地终端运行
ssh -V，确认 OpenSSH 已安装且版本 ≥ 7.2（Windows 用户推荐用 WSL2 的ssh，别用 Git Bash 自带的旧版） - Mac 和 Linux 用户检查
~/.ssh/config里 Host 别名是否拼错，路径权限是否正确（chmod 600 ~/.ssh/id_rsa，chmod 700 ~/.ssh） - Windows 上若用 PowerShell，确保
$env:PATH包含 OpenSSH 目录（如C:\Windows\System32\OpenSSH\），否则 VSCode 可能找不到ssh
连接后自动断开或卡在 “Installing VS Code Server”
VSCode 远程模式会在服务器上部署一个轻量服务端（vscode-server），它需要写入用户主目录下的 ~/.vscode-server，并能执行 Node.js。
典型表现：连接成功几秒后断开，日志里出现 spawn ENOENT 或 Permission denied (publickey) 后续又变成 Connection reset by peer。
- 确认服务器已安装
node（至少 v14+），运行node --version验证；某些最小化系统（如 Alpine、CentOS Stream）默认没装 - 检查磁盘空间和 inodes：如果
~/.vscode-server所在分区满或 inode 耗尽，安装会静默失败 - 若服务器禁用了
~/.bashrc或~/.profile中的node路径，远程 shell 可能找不到命令——可在~/.ssh/config中加SetEnv NODE_OPTIONS=--max_old_space_size=4096测试，或改用完整路径启动（不推荐，但可临时验证）
编辑大文件卡顿、Git 操作慢、终端响应延迟
这不是 VSCode 本身的问题，而是 Remote-SSH 默认把所有文件操作走网络传输，尤其遇到大量小文件（比如 node_modules）时，性能会断崖式下跌。
真实使用场景：你在本地开项目，但后端服务、数据库、配置都在远程机器上，你只想编辑代码 + 快速跑单元测试，不需要同步整个 node_modules。
- 务必在远程窗口中打开单个文件夹（而非整个家目录），并在
.vscode/settings.json里配"files.exclude"和"search.exclude"，例如："**/node_modules": true - 禁用可能触发远程扫描的插件：比如某些 LSP 客户端、文件监视器（
files.watcherExclude也要设）、或者“保存时自动格式化”如果后端没装对应 formatter - Git 操作慢？是因为 VSCode 默认调用远程
git。如果本地也有仓库镜像，可用git remote set-url origin指向本地路径，或直接在本地终端操作 Git，只用 VSCode 编辑
私钥有密码但每次连接都弹窗输一遍
VSCode Remote-SSH 本身不缓存 SSH 密钥密码，它复用系统的 ssh-agent 行为。弹窗频繁，说明 agent 没生效或 key 没添加进去。
注意：Windows 上 OpenSSH 的 agent 默认不随系统启动，Mac 的 Keychain 有时会拒绝 VSCode 访问。
- Linux/macOS：运行
eval $(ssh-agent)+ssh-add ~/.ssh/id_rsa，再启动 VSCode（不是从 Dock 点开，而是终端里执行code） - macOS：如果用了 Keychain，首次添加后应勾选 “Remember password in my keychain”，否则下次重启仍要输
- Windows（WSL2）：确保
service ssh start已运行，并在 WSL 内执行ssh-add ~/.ssh/id_rsa；原生 Windows OpenSSH agent 需手动启用服务（Get-Service ssh-agent | Set-Service -StartupType Automatic）
ssh 路径、node 可见性、~/.vscode-server 权限、还有 agent 是否真在管事——这四个点漏掉任何一个，都会让整个流程停在看似莫名其妙的环节。
