VS Code通过Remote-SSH连接失败主因是权限与密钥配置不当：本地私钥（600）、config（600）、远程authorized_keys（600）及.ssh目录（700）权限须合规；需确认SSH配置路径一致、禁用ssh-agent依赖、远程sshd启用PubkeyAuthentication，并注意Ed25519密钥在旧服务器上的兼容性问题。
VS Code 通过 Remote-SSH 扩展连接远程服务器时，最常见的失败原因就是权限配置不当或 SSH 密钥不被正确识别。核心问题通常不是“连不上”，而是“连上了但被拒绝”——比如提示 Permission denied (publickey) 或 Failed to authenticate。关键在于本地 SSH 配置、密钥格式、远程用户家目录及 .ssh 权限三者必须同时合规。
检查并修复本地 SSH 密钥权限
OpenSSH 对私钥文件权限极其敏感：私钥（如 id_rsa）不能被组或其他人读写，否则直接忽略。Windows（WSL 或 Git Bash）和 macOS/Linux 都适用此规则。
- 运行
ls -l ~/.ssh/id_rsa（Linux/macOS）或ls -l $HOME/.ssh/id_rsa（WSL），确认输出中权限为-rw-------（即 600） - 如果不是，执行：
chmod 600 ~/.ssh/id_rsa - 同理，确保
~/.ssh/config权限为 600，~/.ssh/authorized_keys（远程端）为 600，~/.ssh目录为 700 - 避免用记事本或 VS Code 直接编辑私钥文件——可能引入 BOM 或换行符错误；推荐用
vim或code --disable-extensions编辑
确认 VS Code 使用的是正确的 SSH 配置路径
Remote-SSH 默认读取系统 SSH 配置（~/.ssh/config），但如果你在 Windows 上用 OpenSSH for Windows，或自定义了 SSH_CONFIG_FILE 环境变量，VS Code 可能找不到配置。
- 在 VS Code 命令面板（
Ctrl+Shift+P）中运行Remote-SSH: Open Configuration File...，选择对应平台的 config 路径，确保它和终端里ssh -F指定的路径一致 - 在
~/.ssh/config中明确指定密钥路径：Host myserver
HostName 192.168.1.100
User alice
IdentityFile ~/.ssh/my_private_key - 避免使用
ssh-add后依赖 agent —— Remote-SSH 默认不继承终端的 ssh-agent，除非你启用了"remote.ssh.enableAgentForwarding": true并确认 agent 正常运行
验证远程端 sshd 配置与用户环境
即使密钥和权限都对，远程服务器的 SSH 守护进程也可能禁用公钥认证，或用户 shell、家目录权限异常导致认证跳过。
- 登录服务器终端，检查
/etc/ssh/sshd_config是否含：PubkeyAuthentication yes
AuthorizedKeysFile .ssh/authorized_keys
修改后需重启服务：sudo systemctl restart sshd - 确认远程用户家目录属主是该用户，且不可被组/其他写：
chmod 755 ~（不是 777！） - 检查
~/.ssh/authorized_keys内容是否完整、无多余空格或换行；每行一个公钥，开头是ssh-rsa或ssh-ed25519，结尾是邮箱或注释 - 临时用命令行测试：
ssh -v -F ~/.ssh/config myserver，观察日志中是否尝试 publickey、是否报Authentication refused或no mutual signature algorithm（后者常见于旧版 OpenSSH 与新密钥类型不兼容）
处理常见密钥类型与兼容性问题
新版 ssh-keygen 默认生成 Ed25519 密钥，但部分老旧服务器（如 CentOS 7 默认 OpenSSH 6.6）不支持。若遇到 no mutual signature algorithm，需降级生成 RSA 密钥。
- 生成兼容性更强的 RSA 密钥：
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa_compatible - 将公钥追加到远程：
ssh-copy-id -i ~/.ssh/id_rsa_compatible.pub user@host（若失败，手动复制内容到~/.ssh/authorized_keys） - 在
~/.ssh/config中绑定该密钥：IdentityFile ~/.ssh/id_rsa_compatible - Windows 用户注意：PuTTYgen 生成的密钥默认是 PPK 格式，VS Code 不支持；需用 PuTTYgen → Conversions → Export OpenSSH key（无密码）再使用
基本上就这些。多数连接失败不是网络问题，而是权限链上某一处松动——从本地私钥权限、config 文件路径、远程目录结构到 sshd 配置，环环相扣。逐项核对日志输出，比反复重试更有效。
