VSCode Remote-SSH 连接失败主因是 SSH 配置或环境问题：本地 ~/.ssh/config 格式错误、私钥权限非600、缺少 curl/tar、磁盘满、/home noexec 挂载、未正确加载 shell 环境（需加 VSCODE_PID 判断）、插件未禁用或解释器路径错误。
VSCode 本身不“连接”服务器，Remote-SSH 插件只是把后端运行在远程机器上——连不上，90% 是 SSH 层没通，不是插件坏了。
为什么 ssh user@host 能通，但 VSCode 连不上？
因为 VSCode 的 Remote-SSH 不用你输密码或点确认，它完全依赖本地 ~/.ssh/config 文件；哪怕只多一个空格、少一个冒号，或者 HostName 写成 hostname（大小写敏感），都会静默失败，只显示 “Could not establish connection”。
- 务必先在终端跑一遍：
ssh -F ~/.ssh/config myserver（myserver是你 config 里写的Host名），通了 VSCode 才可能通 - Windows 用户注意：
PowerShell和WSL的~/.ssh/config不互通；VSCode 默认走系统 PATH 下的ssh，不是你常用的那一个 - 私钥路径必须写绝对路径，且权限得是
600：chmod 600 ~/.ssh/id_rsa_prod，否则报Permission denied (publickey)却不提示原因
Waiting for server to start... 卡住不动？检查远程有没有 curl 和 tar
VSCode 第一次连，会在服务器自动下载并解压 vscode-server，这一步硬依赖 curl（或 wget）和 tar。Alpine、Debian-slim、最小化镜像常缺这两个命令，或缺 glibc，导致下载完也起不来服务。
- 登录服务器后执行：
which curl tar，都得有输出；没有就装：apt install curl tar（Debian/Ubuntu）或apk add curl tar（Alpine） - 检查磁盘空间：
df -h ~/.vscode-server /tmp，No space left on device会静默失败 - 某些企业服务器挂载
/home时加了noexec，导致~/.vscode-server/bin/xxx/code-server无法执行——这不是你能改的，得找运维
连上了却打不开文件夹、终端卡、Python 找不到解释器？
不是网络慢，是 VSCode 没加载对环境：它不会自动 source ~/.bashrc，所以你终端里能用的命令、PATH、别名，在 VS Code 集成终端里全失效。
- 在
~/.bashrc开头加一句：if [ -n "$VSCODE_PID" ]; then return; fi，再确保~/.profile或/etc/profile正确加载了它 - 禁用所有本地插件：右下角点
Remote [SSH]→Disable All Installed Extensions，否则本地 Python 插件会试图在远程跑前端逻辑，直接报错 -
python.defaultInterpreterPath这类设置必须填远程路径，比如"/usr/bin/python3"，不能留空或写本地路径
最麻烦的不是“怎么连”，而是“连上之后 VSCode 根本不认你服务器上的环境”——它启动时绕过了你的 shell 初始化流程，又默认信任本地配置，这两者一撞，问题就藏得特别深。
