VSCode怎么使用Remote-SSH进行远程开发-VSCode-PHP中文网

Remote-SSH连接失败需先确保终端ssh直连成功：一、用ssh命令验证连通性及认证；二、检查~/.ssh/config语法与路径；三、确认远程sshd服务运行及用户权限；四、清除VSCode缓存；五、启用debug日志定位错误。

vscode怎么使用remote-ssh进行远程开发

Remote-SSH 不是“点一下就连上”的功能，它本质是复用你本地的 SSH 环境。连不上、卡在 Installing VS Code Server...、弹密码框却输不对——这些问题 90% 都出在 SSH 层，而不是 VSCode 插件本身。

先确保终端能 `ssh` 直连成功

VSCode 的 Remote-SSH 插件底层调用的是你系统 PATH 下的 ssh 命令，不是它自己带的。跳过这步直接开 VSCode，等于没打地基就盖楼。

在终端里执行：ssh -i ~/.ssh/my_key user@192.168.1.100 -p 2222（把路径、用户、IP、端口换成你的真实值）
如果报 Permission denied (publickey)，别急着重装插件——检查三件事：
– 私钥权限是否为 600（chmod 600 ~/.ssh/my_key）
– 远程 ~/.ssh/authorized_keys 是否真有那行公钥（末尾不能有多余空格或换行）
– 远程 /etc/ssh/sshd_config 是否启用 PubkeyAuthentication yes 且 AllowUsers 包含你的用户名
如果连通但输出了欢迎语、颜色码、echo 内容，VSCode 会解析失败，报 Failed to fetch remote environment。临时验证可运行：ssh -T user@host，干净返回 Connection closed. 才算过关

用 `~/.ssh/config` 定义 Host 别名，别信 UI 里手填

VSCode 的远程主机列表完全来自 ~/.ssh/config 文件。你在插件 UI 里点 + 号手动填 IP，生成的配置不可复用、不支持密钥路径、没法 alias，纯属自找麻烦。

编辑 ~/.ssh/config，添加标准块（注意：缩进必须是空格，不能是 Tab）：

Host myserver
  HostName 192.168.1.100
  User ubuntu
  Port 2222
  IdentityFile ~/.ssh/id_ed25519
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null

保存后，按 Ctrl+Shift+P → 输入 Remote-SSH: Reload Window，再打开 Remote-SSH: Connect to Host，就能看到 myserver
StrictHostKeyChecking no 和 UserKnownHostsFile /dev/null 是为了绕过 known_hosts 变更导致的连接中断（比如服务器重装），生产环境慎用，调试阶段很省心

`vscode-server` 卡住或安装失败，大概率是远程环境缺依赖或权限错

SSH 登录成功后，VSCode 会在远程自动下载并启动 vscode-server。卡在这里，不是网络慢，而是远程机器没准备好。

VSCode

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

下载

远程服务器必须有 curl、tar、gzip（用于解压 server 包），CentOS/RHEL 系统常缺 tar，运行 yum install -y tar 补上
检查远程用户对 ~/.vscode-server 目录是否有写权限：ls -ld ~/.vscode-server，若属主不是当前用户，用 chown -R $USER:$USER ~/.vscode-server 修复
某些精简系统默认 shell 是 /bin/sh，但 vscode-server 启动脚本依赖 bash 特性。确认 getent passwd $USER | cut -d: -f7 返回的是 /bin/bash 或 /bin/zsh；不是的话，用 chsh -s $(which bash) 改掉

免密登录不是可选项，是稳定使用的前提

每次连都输密码，不仅烦，还会触发 SSH 连接数限制、密钥代理失效等连锁问题。VSCode 的自动初始化逻辑（比如加载扩展、恢复会话）也依赖稳定、无交互的连接通道。

生成密钥优先用 ed25519：ssh-keygen -t ed25519 -C "your@email.com"
部署公钥别只靠 ssh-copy-id —— 登上去手动检查 ~/.ssh/authorized_keys 文件末尾是否真有一行完整的公钥（开头是 ssh-ed25519 AAAA...，结尾没换行符）
如果私钥设了 passphrase，VSCode 启动时会弹窗要你输——这不是 bug，是正常行为。想彻底免交互，就生成时两次回车跳过 passphrase

最常被忽略的一点：VSCode Remote-SSH 的所有行为，都建立在「你本地的 ssh 命令能做什么」之上。它不封装 SSH，只是调用。排查问题时，永远先回到终端，用最原始的 ssh 命令复现，比在 VSCode 里反复点连接快十倍。