必须安装microsoft官方remote - ssh插件，认准发布者为microsoft、蓝底白箭头图标、描述含“connect to remote machines via ssh”，左下角出现绿色按钮且启用正常，windows用户需启用系统openssh客户端。
装对插件只是起点，真正卡住人的几乎全是后续配置和权限问题——比如 ~/.ssh/config 多一个空格、密码输错三次触发 SSH 限流、或远程服务器没装 curl 导致 vscode-server 下载失败。
怎么确认 Remote - SSH 插件装对了
别只看名字，必须核对三点：
- 发布者是
Microsoft（不是“SSH Tools”“Remote SSH Lite”等第三方） - 图标是蓝底白箭头（两个相向的小箭头），不是终端、锁或地球图标
- 描述里明确写着
Connect to remote machines via SSH and develop with full VS Code functionality
装完立刻检查左下角：必须出现绿色按钮（两个相向箭头）。没有？不是重启窗口，是彻底关闭 VSCode 再打开；如果还有，进扩展面板搜 Remote - SSH，确认右上角显示“已启用”，不是“已安装”或“已禁用”。
Windows 用户连不上？先查 OpenSSH 客户端
Remote - SSH 不自带 SSH 客户端，它直接调用系统 ssh 命令。Windows 用户常在这里翻车：
- 打开 CMD 或 PowerShell，运行
ssh -V，能输出版本号才说明客户端就位 - 如果报错
'ssh' is not recognized，去「设置 → 应用 → 可选功能 → 添加功能」，勾选OpenSSH 客户端 - 别用 PuTTY、Xshell 或其他 GUI SSH 工具替代——它们不提供
ssh命令行，Remote - SSH 根本无法调用
添加服务器时，~/.ssh/config 的写法必须严格
VSCode 会读取这个文件来解析 Host 别名，格式容错率极低：
- 每行只能有一个配置项，
Host、HostName、User、Port各占一行，不能合并或加注释在同行 -
HostName后面必须是 IP 或可解析的域名，不能带http://或端口（端口单独写Port行） - 路径中不要用中文或空格；Windows 默认路径是
C:\Users\用户名\.ssh\config，保存时编码选 UTF-8 无 BOM - 示例正确写法：
Host gpu-server HostName 117.50.171.20 User root Port 22
写成 Host gpu-server # 注释 或 HostName 117.50.171.20:22 都会导致连接卡在“正在下载 vscode-server”不动。
首次连接卡在“Downloading VS Code Server”？重点查这三处
vscode-server 是远程端必需的轻量服务，下载失败不会报明显错误，只会假死：
- 远程服务器是否能访问公网？执行
curl -I https://vscode.download.prss.microsoft.com看是否返回200；国内云服务器常因 DNS 或防火墙阻断，需手动离线部署 - 远程用户家目录是否有写权限？
~/.vscode-server目录需可写，root用户一般没问题，但ubuntu用户可能被限制 - 远程是否装了
curl或wget？某些最小化镜像（如 Alpine）默认不带，导致下载逻辑直接退出
真正麻烦的不是插件装不装得上，而是你连上之后发现终端打不开、Python 解释器选不了、Git 状态不刷新——这些问题 90% 出现在 vscode-server 没跑起来，而不是 SSH 连接本身。
