只需安装Microsoft官方Remote - SSH插件，禁用其他SSH类插件；必须配置~/.ssh/config（含Host/HostName/User/IdentityFile/Port），私钥权限设为600；首次连接卡在“Installing VS Code Server”时需检查远程是否具备curl、tar及磁盘空间，并手动部署匹配commit ID的vscode-server包。
只需要装 Remote - SSH 这一个插件，别的都别碰——装多反而冲突，连不上、命令找不到、终端打不开，八成是插件混了。
只认 Remote - SSH，别被名字带偏
VSCode 官方 Remote 套件有三个独立插件：Remote - SSH、Remote - Containers、Remote - WSL。你只要第一个。搜索时务必核对作者是 Microsoft，全名必须是 Remote - SSH。
常见踩坑点：
- 搜“ssh”出来一堆类似名字，比如
SSH FS、SSH Client、SSH Remote—— 这些只能浏览文件或发命令，不支持调试、语言服务、远程插件安装 - 装了
Remote Development扩展包？没问题，但它只是合集，真正起作用的仍是其中的Remote - SSH子项 - 装完没重启 VSCode 或没重载窗口，
Ctrl+Shift+P里搜不到Remote-SSH: Connect to Host，大概率是没生效
~/.ssh/config 是连接命脉，不是可选项
VSCode 的 Remote - SSH 不走 UI 表单输 IP/密码那一套，它直接读系统级 SSH 配置文件。Windows 路径是 %USERPROFILE%\.ssh\config，macOS/Linux 是 ~/.ssh/config。没这个文件，或者权限不对（比如 chmod 600 ~/.ssh/config 没做），连接就会卡在认证环节。
一个能用的最小配置示例：
Host my-prod
HostName 192.168.50.12
User deploy
IdentityFile ~/.ssh/id_ed25519
Port 2222
注意：
-
IdentityFile必须指向私钥，且该文件权限得是600，否则 SSH 拒绝读取 - 别用密码登录：远程服务器若禁用了密码认证（合理做法），而你又没配密钥，连接会直接失败，错误信息常是
Permission denied (publickey) - 跳转主机（Jump Host）场景下，
ProxyJump必须写在~/.ssh/config里，UI 配置不支持
首次连接卡在 Installing VS Code Server 怎么办
这不是界面假死，而是远程正在拉取并解压 vscode-server。失败原因往往藏在底层依赖里：
- 远程机器没装
curl或wget，下载阶段就中断（Ubuntu/Debian 可sudo apt install -y curl wget） - 国内网络访问 GitHub 或微软 CDN 不稳定，自动下载超时；此时得手动传包：
vscode-server-linux-x64.tar.gz（注意匹配本地 VS Code 的 Commit ID 和 CPU 架构） - 远程磁盘空间不足，
~/.vscode-server目录写不进去，df -h ~看一眼 - 远程用户家目录权限太松（如
777），OpenSSH 会拒绝执行，报错类似Bad owner or permissions
最常被忽略的一点：VSCode 从不帮你装 Python、Node.js 或 Go——它只管把编辑器跑起来。远程环境是否具备项目运行所需的一切，得你自己确认。
