VSCode Remote-SSH 成功连接需打通本地 SSH 配置、密钥权限、插件链和远程环境四关：先终端直连验证，再配 ~/.ssh/config，确保远程有 curl/tar 等依赖及 ~/.vscode-server 权限，最后通过 ProxyJump 支持多跳并用 VSCODE_IPC_HOOK 触发自动初始化。
在 VSCode 中通过 Remote-SSH 连接并操作远程服务器，不是简单点一下“Connect to Host”，而是要打通本地 SSH 配置、密钥权限、VSCode Remote 插件链和远程环境初始化这四关。只要其中一环出错，就会卡在 Setting up SSH Host、Failed to fetch remote environment 或 Permission denied (publickey)。
下面是你真正需要的实操配置路径，覆盖 95% 的真实报错场景：
一、确保本地 SSH 能直连，是 Remote-SSH 的前提
VSCode 的 Remote-SSH 插件底层调用的是你系统 PATH 下的 ssh 命令，不是它自带的。所以第一步永远是：在终端里手动执行成功。
运行：
ssh -i ~/.ssh/my_key user@192.168.1.100 -p 2222
如果失败（如 Permission denied (publickey)），别急着开 VSCode —— 先修复 SSH 本身：
- 检查私钥权限：
chmod 600 ~/.ssh/my_key - 确认公钥已追加到远程
~/.ssh/authorized_keys（注意换行、无空格、末尾无多余字符） - 检查远程
/etc/ssh/sshd_config是否启用：PubkeyAuthentication yes且AllowUsers包含你的用户
二、正确配置 VSCode 的 SSH Host 列表（~/.ssh/config）
VSCode 的 Remote-SSH 主界面显示的主机列表，完全来自你本地的 ~/.ssh/config 文件。不要试图在插件 UI 里“手动填 IP”——那不可复用、不支持 IdentityFile、无法 alias。
在 ~/.ssh/config 中添加标准块（注意缩进是空格，非 Tab）：
Host myserver HostName 192.168.1.100 User ubuntu Port 2222 IdentityFile ~/.ssh/my_key StrictHostKeyChecking no UserKnownHostsFile /dev/null
保存后重启 VSCode，或按 Ctrl+Shift+P → 输入 Remote-SSH: Reload Window，再打开命令面板 → Remote-SSH: Connect to Host... 就能看到 myserver。
三、解决“连接成功但无法加载远程 VS Code Server”问题
常见现象：SSH 登录成功，VSCode 显示 “Installing VS Code Server…” 卡住，或报错 Failed to fetch remote environment、Cannot create directory /home/user/.vscode-server。
根本原因：远程机器缺少基础依赖，或磁盘/权限受限。请按顺序排查：
✅ 远程必须预装 curl、wget、tar、gzip（Ubuntu/Debian 执行 sudo apt update && sudo apt install -y curl wget tar gzip）
✅ 确保远程用户对 ~/.vscode-server 有完整读写权限（尤其 Docker 容器或 NFS 挂载家目录时易出问题）
✅ 如果远程是 Alpine、CentOS Stream 等精简系统，可能缺 libstdc++.so.6 或 glibc —— 可临时指定使用旧版 server（在 VSCode 设置中搜索 remote.ssh.serverInstallPath，设为空；或连接时按 Ctrl+Shift+P → Remote-SSH: Kill VS Code Server on Host... 清理后重试）
四、进阶：免密码 + 多跳 + 自动启动服务
生产环境常需跳板机（Bastion）或自动拉起 Python/Node 服务。这时靠 UI 点击不行，必须靠 ~/.ssh/config 驱动：
Host jump HostName 203.0.113.10 User admin IdentityFile ~/.ssh/bastion_keyHost target HostName 10.0.1.5 User dev IdentityFile ~/.ssh/target_key ProxyJump jump
这样在 VSCode 里选 target，会自动走跳板机。若还需连接后自动激活 Conda 环境或启动 tmux，可在远程 ~/.bashrc 末尾加：
if [ -n "$VSCODE_IPC_HOOK" ]; then conda activate myenv tmux attach || tmux new-session fi
（VSCODE_IPC_HOOK 是 VSCode 启动远程 shell 时注入的环境变量，可精准识别是否为 Remote-SSH 会话）
最常被忽略的一点：Remote-SSH 不会自动 source ~/.zshrc 或 ~/.profile，只认 ~/.bashrc（即使你默认 shell 是 zsh）。如果你的 PATH、conda、nvm 等都在 zsh 配置里，远程终端能用，但 VSCode 内置终端却找不到 python 或 node —— 解决方案是在 ~/.bashrc 里显式加载它：source ~/.zshrc 2>/dev/null || true。
