如何用VSCode_管理你的SSH远程连接【教程】

vscode 的 Remote-ssh 插件依赖系统 SSH 配置，仅读取格式正确的 ~/.ssh/config 中 Host 条目；常见问题包括 Host 行末尾空格、缺 HostName、私钥路径含空格未加引号、config 权限非 600；端口/用户须在 config 显式声明，IdentitiesOnly yes 可避免多密钥干扰；连接失败时需通过终端运行 ssh 命令验证，而非仅依赖 VSCode 日志。

VSCode 本身不管理 SSH 连接，它依赖系统已配置好的 ssh 命令和 ~/.ssh/config 文件——这意味着你不能在 VSCode 里“新建连接”或“保存密码”，所有连接逻辑都在终端 SSH 层。

为什么 Remote-SSH 插件找不到你的主机

Remote-SSH（官方插件）启动时会读取 ~/.ssh/config，但只识别符合格式的 Host 条目；常见失效原因：

• Host 行末尾有空格或 Tab，导致解析失败
• 用了别名但没配 HostName（例如只写 Host myserver 却没下一行 HostName 192.168.1.100）
• 私钥路径含空格或中文，且没用引号包裹（IdentityFile ~/.ssh/id_rsa_prod ✅，IdentityFile ~/Dropbox/keys/id_rsa ❌）
• 文件权限太宽松：~/.ssh/config 必须是 600，否则 OpenSSH 拒绝读取

如何让 VSCode 正确加载带端口/用户的 SSH 配置

Remote-SSH 不支持在连接字符串里直接写端口或用户（比如 user@host:2222），必须靠 ~/.ssh/config 显式声明：

Host prod-server     HostName 203.0.113.5     User deploy     Port 2222     IdentityFile ~/.ssh/id_ed25519_prod     IdentitiesOnly yes

之后在 VSCode 命令面板（Ctrl+Shift+P）运行 Remote-SSH: Connect to Host...，就能看到 prod-server 可选；IdentitiesOnly yes 很关键——它防止 SSH 尝试默认密钥导致连接卡住。

连接失败时该看哪几行日志

点击 VSCode 左下角 “Remote” 状态栏 → “Open SSH Configuration File”，再执行连接，然后打开命令面板运行 Remote-SSH: Show Log。重点关注：

• Running ssh -F /dev/NULL -o ConnectTimeout=15 ... —— 它实际调用的命令，可复制到终端手动跑一遍验证
• Received disconnect from ...: 2: Too many authentication failures —— 通常是本地有多个密钥，服务端拒绝继续尝试，加 IdentitiesOnly yes 解决
• Permission denied (publickey) —— 不是密码错，而是密钥未被接受，检查 ssh -T -v prod-server 输出中是否成功用了目标私钥

真正麻烦的不是配置步骤，而是 SSH 层的静默失败：VSCode 不报错，只停在“正在建立连接…”；这时候必须切到终端，用原生命令验证 ssh 是否真能连，否则所有 VSCode 操作都是在猜。