VS Code远程连接失败主因是vscode-server无法在服务器静默启动，常见于权限不足、磁盘满、SELinux限制或shell配置输出阻塞；需检查目录权限、清理旧版本、禁用非条件echo、启用agent转发并确保shell环境完整加载。
VS Code 远程连接服务器不是“装个插件就能用”，关键在于 vscode-server 能否在目标机器上静默、稳定、权限正确地启动——多数失败都卡在这一步，而不是 SSH 配置本身。
为什么 Remote-SSH 点连接后卡在“正在下载 VS Code Server”？
这不是网络慢，而是远程用户没有写入 ~/.vscode-server 目录的权限，或磁盘空间不足/SELinux 限制/Shell 初始化脚本（如 .zshrc）里有阻塞输出的命令（比如 echo 或未加 [ -t 0 ] 判断的交互式提示）。
- 先手动 SSH 登录，运行
mkdir -p ~/.vscode-server/bin，再ls -ld ~ ~/.vscode-server确认属主和权限（应为当前用户，非root） - 检查
df -h和getenforce（若为Enforcing，临时设为Permissive测试是否 SELinux 拦截） - 把
.bashrc或.zshrc开头所有非条件判断的echo/printf注释掉，再试
vscode-server 版本不匹配导致反复重装
本地 VS Code 版本升级后，会尝试拉取对应 commit ID 的 server 二进制；但若远程已有旧版且权限锁死，它不会覆盖，而是新建目录，最终填满 ~/.vscode-server/bin/ 并报错 Failed to fetch configuration。
- 定期清理：运行
rm -rf ~/.vscode-server/bin/*（确保没人在用远程窗口） - 强制指定版本：在 SSH 连接配置中加
"remote.SSH.serverPickPortsFromConfig": false，并手动设置"remote.SSH.useLocalServer": true（仅限可信内网） - 更稳的做法：用
code --install-extension ms-vscode-remote.remote-ssh确保本地插件最新，再删远程~/.vscode-server重连
免密登录 + 多跳跳转（Bastion Host）怎么配才不弹密码框？
VS Code 的 Remote-SSH 不读取 ssh-agent 的转发状态，必须显式启用代理转发，且中间跳板机需允许 ForwardAgent yes。
- 本地
~/.ssh/config中对应 Host 块必须包含：ForwardAgent yesProxyJump user@jump-host - 跳板机的
/etc/ssh/sshd_config必须有AllowAgentForwarding yes，改完记得sudo systemctl reload sshd - 别用密码登录跳板机——哪怕配了
IdentitiesOnly yes，只要私钥没加ssh-add，依然会弹窗；用ssh-add ~/.ssh/id_rsa预加载
真正麻烦的从来不是“连不上”，而是连上了却无法触发断点调试、终端中文乱码、或 Git 提交时提示 unable to read askpass response——这些都指向同一个底层事实：远程 shell 环境没被完整加载，而 VS Code 默认只读 ~/.profile，忽略 .zshrc 或 .bashrc 里的 PATH 和 alias。这点很容易被忽略，直到你发现 python 命令根本不在 PATH 里。
