最稳定可靠的远程连接方式是使用 ctrl+shift+p（win/linux）或 cmd+shift+p（macos）调出命令面板，输入 remote-ssh: connect to host；该命令支持模糊搜索、实时过滤、明确连接控制，且不受 ui 渲染延迟影响，而左下角绿色按钮行为不稳定、不显示 host 列表、无搜索功能。
直接按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Remote-SSH: Connect to Host 即可呼出远程连接列表——这是最稳定、最可控的方式，比点击左下角绿色按钮更可靠。
为什么不能只依赖左下角绿色按钮？
左下角绿色按钮（两个相向箭头）看似快捷，但实际行为不稳定：
- 它有时只显示“Connect to Host in New Window”，不列出已保存的 Host 列表，尤其在 Remote Explorer 面板未展开或插件刚加载时
- 点击后若无响应，容易误判为“连接失败”，其实是 UI 渲染延迟或状态未就绪
- 它不支持模糊搜索，无法快速定位某个 Host（比如你有 8 个服务器，靠肉眼找效率极低）
Remote-SSH: Connect to Host 命令的实际行为
该命令会立即拉起一个带搜索框的下拉菜单，列出所有已配置的 Host 条目（来自 ~/.ssh/config 或 VSCode 自动写入的配置），并支持实时过滤：
- 输入部分名称（如
gpu）即可匹配Host gpu-server、Host cloud-gpu - 回车即触发连接流程，跳过中间确认步骤
- 若当前已有连接，会提示是否关闭现有连接或新开窗口——这个决策由你控制，不会自动覆盖
配置没出现在列表里？检查这三个位置
命令列表为空或缺项，通常不是插件问题，而是配置未被识别：
-
~/.ssh/config文件中，每个Host块必须顶格写，且HostName和User不可缩进（空格/Tab 会导致解析失败） - VSCode 没有读取到该文件：在命令面板输入
Remote-SSH: Open SSH Configuration File，确认打开的是你编辑的那个路径（常见错误是误选了系统级C:\ProgramData\ssh\ssh_config） - 配置中用了
IdentityFile但路径错误或权限不对（Windows 上路径含空格需加引号，Linux/macOS 上~不展开，必须写成/home/user/.ssh/id_rsa）
连接卡在“正在安装 VS Code Server”？别干等
首次连接时，VSCode 会在远程服务器上部署服务端组件（vscode-server），但这个过程可能因网络或权限卡住：
- 查看远程终端输出：连接后按
Ctrl+Shift+~打开集成终端，观察是否有Downloading VS Code Server日志；若长时间停在Installing，说明下载中断 - 手动补救：登录服务器终端，删掉残留目录
rm -rf ~/.vscode-server，再重试连接 - 国内用户常见问题：GitHub Release 下载慢，可提前在服务器上手动下载对应版本（URL 格式类似
https://update.code.visualstudio.com/commit:<hash>/server-linux-x64/stable</hash>），解压到~/.vscode-server/bin/<hash></hash>
真正麻烦的不是连不上，而是连上了却不知道该信谁——比如 known_hosts 里存着旧密钥，新服务器换 IP 后弹窗警告“REMOTE HOST IDENTIFICATION HAS CHANGED”，这时候点“Continue”还是“Cancel”，取决于你是否确认服务器确实重装过。这种细节，没人提醒，但一错就得重配整个环境。
