必须安装 microsoft 官方发布的 remote - ssh 插件，认准发布者为 microsoft、蓝底白箭头图标、描述含“connect to remote machines via ssh...”，左下角出现绿色按钮且启用状态正常，windows 用户需确保系统启用 openssh 客户端。
直接装 Remote - SSH 就行，别装错成第三方“SSH”或“Remote XXX”类插件——只有 Microsoft 官方发布的 Remote - SSH（作者是 Microsoft）才能真正支持远程文件浏览、终端、调试全流程。
怎么确认装的是对的插件
打开 VSCode 扩展面板（Ctrl+Shift+X），搜 Remote - SSH，认准三点：
- 发布者必须是
Microsoft - 图标是蓝底白箭头（两个相向的小箭头）
- 描述里有 “Connect to remote machines via SSH and develop with full VS Code functionality”
如果看到名字类似 SSH FS、Remote SSH Lite 或作者不是 Microsoft，一律跳过——这些不走 VSCode 官方远程协议栈，无法加载 vscode-server，后续连不上、终端打不开、Python 解释器选不了都是大概率。
装完没反应？检查左下角有没有绿色按钮
安装成功后，VSCode 窗口左下角会立刻出现一个绿色小按钮（两个相向箭头）。如果没有：
- 重启 VSCode（不是重载窗口，是彻底关闭再打开）
- 检查是否启用了扩展：点开扩展面板，搜
Remote - SSH，确认右上角是“已启用”，不是“已禁用”或“已安装但未启用” - Windows 用户注意：
Remote - SSH依赖系统自带 OpenSSH。运行ssh -V命令验证能否识别；若报错“不是内部或外部命令”，需手动启用 Windows 功能里的“OpenSSH 客户端”
别顺手装“Remote Development”套件
搜 Remote Development 会出来一个蓝色终端图标的合集包，它包含 Remote - SSH、Remote - Containers、Remote - WSL 三个子插件。可以装，但要注意：
- 如果你只连 Linux 云服务器，单独装
Remote - SSH更轻量、出问题更容易定位 - 这个套件会一并安装
Remote - WSL，在 Windows 上可能和你本地 WSL 冲突（比如终端默认打开 WSL 而非远程 SSH） - 某些旧版 VSCode（Remote - SSH 更稳
装完插件只是第一步，真正卡住人的往往在 SSH 配置和权限环节——尤其是密码登录失败、密钥路径不对、~/.ssh/config 格式多一个空格，都会让连接停在“正在下载 vscode-server”不动。这些细节比插件本身更值得盯紧。
