Remote-SSH连接失败需系统排查：先验证本地ssh命令连通性，再检查远程SSH服务、网络、vscode-server部署及配置文件语法与权限，任一环节异常均会导致连接卡顿或失败。
Remote SSH 不是“连上服务器就能用”的功能，它依赖本地 SSH 客户端、远程 SSH 服务、网络可达性、以及 vscode-server 的自动部署能力。只要其中一环断掉，就会卡在“连接中”“下载失败”或“Permission denied”——不是插件装了就万事大吉。
Remote-SSH 插件安装后无法连接，先确认本地 ssh 命令能否通
VSCode 的 Remote-SSH 本质是调用你系统的 ssh 命令，不是自己实现 SSH 协议。所以第一步永远是：在终端里手动执行一遍你要连的命令。
- Windows 用户打开 PowerShell 或 CMD，运行：
ssh zw@192.168.0.54 - macOS / Linux 用户直接终端运行：
ssh zw@192.168.0.54 - 如果报
command not found: ssh，说明本地没装 OpenSSH 客户端（Win10/11 需手动启用，“设置 → 应用 → 可选功能 → 添加 OpenSSH 客户端”） - 如果报
Connection refused或超时，说明远程 SSH 服务没开、防火墙拦了、或 IP/端口填错 - 如果能成功登录并看到远程 shell，那 VSCode 连接失败大概率出在配置或 vscode-server 部署环节
首次连接卡在 “Downloading VS Code Server” 或报错 Failed to download vscode-server
这是国内用户最常遇到的问题。vscode-server 默认从 https://update.code.visualstudio.com 下载，但该域名在国内访问不稳定，且重定向多、校验严，容易中断或校验失败。
- 不要反复重试——每次失败都会在远程
~/.vscode-server/bin/下留下残缺目录，干扰下一次部署 - 手动下载方式：从浏览器打开
https://update.code.visualstudio.com/commit:<em>hash</em>/server-linux-x64/stable（hash是 VSCode 窗口左下角提示里出现的 commit ID，如6c3e3dba23e8fadc360aed75ce363ba185c49794） - 下载完
vscode-server-linux-x64.tar.gz后，用scp传到远程：scp vscode-server-linux-x64.tar.gz zw@192.168.0.54:~ - 登录远程，解压到对应路径：
mkdir -p ~/.vscode-server/bin/6c3e3dba23e8fadc360aed75ce363ba185c49794 && tar -xzf vscode-server-linux-x64.tar.gz -C ~/.vscode-server/bin/6c3e3dba23e8fadc360aed75ce363ba185c49794 --strip-components 1 - 确保远程有
curl或wget（否则自动部署会直接失败）：which curl || sudo apt install curl（Ubuntu/Debian）
SSH 配置写在 ~/.ssh/config 里，但 VSCode 就是不识别
VSCode 读取 SSH 配置时很“挑”，路径、格式、权限三者必须同时满足，否则就回退到弹窗手动输命令。
- 确认 VSCode 读的是哪个文件：按
Ctrl+Shift+P→ 输入Remote-SSH: Open Configuration File...→ 选 “User”（即~/.ssh/config） -
~/.ssh/config文件权限必须是600：chmod 600 ~/.ssh/config，否则 OpenSSH 会忽略它 - Host 别名不能含下划线或大写字母（部分旧版 OpenSSH 会拒绝），推荐全小写加短横线，如
my-server - 每段 Host 必须顶格写，不能缩进；
HostName、User、IdentityFile等字段值前后不能有多余空格 - 如果用了
IdentityFile，私钥文件本身也得是600：chmod 600 ~/.ssh/id_rsa
连接成功但打开文件夹后终端报错 bash: command not found，或 Python 插件不工作
Remote-SSH 连接后，所有 shell 和语言服务都运行在远程环境里。VSCode 不会帮你装 Python、Node.js、Git 或任何依赖——它只管启动 vscode-server。
- 检查远程是否真有你依赖的命令：
ssh zw@192.168.0.54 'which python3'，如果返回空，就得自己装：sudo apt install python3 python3-pip - Python 扩展默认找
python，但很多系统只有python3，需在远程项目根目录建.vscode/settings.json，写入：{"python.defaultInterpreterPath": "/usr/bin/python3"} - 终端默认 shell 可能不是
bash（比如是sh），导致别名、source等失效。在远程设置里加："terminal.integrated.shell.linux": "/bin/bash" - 插件要装两次：一次在本地（UI 层），一次在远程（运行层）。连接成功后，点击左下角
SSH: xxx→ “Install in SSH: xxx”，再搜 Python 就能装到服务器上
真正麻烦的从来不是“怎么连上”，而是连上之后发现 PATH 不对、shell 不兼容、插件没装对位置、或者 vscode-server 版本和本地 VSCode 不匹配。这些细节不会报红字错误，但会让你改半天配置却始终跑不起来一个 print("hello")。
