VSCode远程SSH连接失败需按五步排查：一、终端执行ssh命令验证连通性；二、修正私钥权限为600并确保PEM格式；三、正确配置~/.ssh/config文件；四、禁用VSCode自动密钥生成；五、启用Verbose日志定位具体错误。
如果您在使用 VSCode 进行远程开发时选择 SSH 作为连接方式，但无法成功建立会话或出现认证失败、端口拒绝、配置不生效等问题，则可能是由于 SSH 配置、密钥权限、服务器服务状态或 VSCode 扩展行为异常所致。以下是针对此类问题的多路径排查与修复操作：
本文运行环境：MacBook Pro，macOS Sequoia。
一、验证本地 SSH 连通性
该步骤用于确认底层 SSH 协议层是否正常工作，排除网络、防火墙及服务端 sshd 守护进程问题。只有基础 SSH 命令能直连成功，VSCode 的 Remote-SSH 才具备运行前提。
1、打开终端，执行 ssh -T username@host_ip -p port_number（若未指定端口则省略 -p 参数）。
2、首次连接时，如提示“Are you sure you want to continue connecting”，输入 yes 并回车。
3、若返回类似 Welcome to Ubuntu 22.04.3 LTS 的欢迎信息，说明 SSH 通道可用；若提示 Connection refused 或 Permission denied (publickey)，需进入后续对应方案。
二、修正 SSH 密钥权限与格式
VSCode Remote-SSH 严格遵循 OpenSSH 的密钥安全策略，私钥文件权限过宽或格式非 PEM 将直接导致认证跳过或静默失败。
1、进入本地密钥所在目录，执行 chmod 600 ~/.ssh/id_rsa（将 id_rsa 替换为实际私钥名）。
2、检查私钥是否为 PEM 格式：执行 head -n 1 ~/.ssh/id_rsa，输出应为 -----BEGIN OPENSSH PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY-----；若为 PuTTY 格式（.ppk），需用 PuTTYgen 转换并导出为 OpenSSH 格式。
3、确保私钥对应公钥已正确追加至远程服务器的 ~/.ssh/authorized_keys，且该文件权限为 600，目录权限为 700。
三、调整 VSCode Remote-SSH 配置文件
Remote-SSH 使用独立的配置文件（config）控制连接行为，其语法错误或路径引用偏差会导致连接中断或自动降级为密码认证。
1、在 VSCode 中按下 Cmd+Shift+P（Mac）调出命令面板，输入并选择 Remote-SSH: Open Configuration File...。
2、选择用户级配置文件（通常为 ~/.ssh/config），在末尾新增如下块（替换对应字段）：
Host my-remote-server
HostName 192.168.1.100
User alice
Port 2222
IdentityFile ~/.ssh/id_rsa_work
StrictHostKeyChecking no
3、保存后，在命令面板中执行 Remote-SSH: Connect to Host...，选择刚定义的 my-remote-server。
四、禁用 VSCode 自动密钥生成行为
VSCode 默认会在连接失败时尝试自动生成新密钥对并覆盖远程 authorized_keys，该行为可能破坏已有认证体系，尤其在共享服务器环境中极易引发权限冲突。
1、打开 VSCode 设置（Cmd+, ），搜索 remote.ssh.generateHostKey。
2、取消勾选该项，或在 settings.json 中手动添加："remote.ssh.generateHostKey": false。
3、同时设置 "remote.ssh.useLocalServer": true，强制复用本地已验证的 SSH agent 环境。
五、启用详细日志定位协议层异常
当界面仅显示“Setting up SSH Host”长时间无响应时，图形界面无法提供有效线索，必须依赖底层日志获取真实错误源。
1、在 VSCode 命令面板中执行 Remote-SSH: Toggle SSH Log Level，将其设为 Verbose。
2、再次尝试连接，连接失败后执行 Remote-SSH: Show Log。
3、在日志中查找含 Failed to parse、Could not resolve hostname、Agent admitted failure 的行，依据关键词匹配对应修复路径。
