只需安装 Remote - SSH 这一个插件,ID 为 ms-vscode-remote.remote-ssh,必须从 VSCode 市场安装在本地,它支撑远程连接、文件浏览、终端启动和插件同步,装错或多装易致路径冲突、挂载失败或终端卡死。

只需要 Remote - SSH 这一个插件,其他都是可选或干扰项。 它是微软官方维护的核心扩展,所有远程连接、文件浏览、终端启动、插件同步都依赖它。装错或装多(比如同时装 SSH FS、SFTP、Remote Explorer 等)反而容易引发路径冲突、挂载失败、终端卡死等问题。
Remote - SSH 插件必须装在本地,且不能少装
插件 ID 是 ms-vscode-remote.remote-ssh,必须从 VSCode 扩展市场安装,不能靠手动复制或离线安装(除非你明确知道如何部署 vscode-server)。安装后无需重启,但要确保状态栏左下角出现 > 图标——这是唯一有效的入口。如果没出现,说明插件未启用或被禁用,检查扩展面板里是否勾选了“启用”。
- Windows/macOS/Linux 通用,不区分系统架构
- 不兼容旧版 VSCode(低于 1.70),建议保持最新稳定版
- 它本身不提供文件传输 UI,也不管理密钥,只复用系统
ssh命令和~/.ssh/config
远程服务器上不需要手动装插件,但需要基础工具链
VSCode 第一次连接时,会在远程用户家目录自动下载并解压 vscode-server,这个过程依赖远程机器有:curl 或 wget、tar、unzip、bash(或兼容 shell),且能访问 update.code.visualstudio.com。如果卡在 “Installing VS Code Server”,不是插件问题,而是远程环境缺失或网络受限。
- Ubuntu/Debian:运行
sudo apt update && sudo apt install -y curl wget tar unzip - CentOS/RHEL:运行
sudo yum install -y curl wget tar unzip或dnf对应命令 - 若服务器无法出网(如内网),需手动下载对应 commit 的 server 包,传到
~/.vscode-server/bin/<commit-id>/</commit-id>下解压
别碰 SSH FS、SFTP、Remote Explorer 这类插件
它们和 Remote - SSH 不兼容,尤其 SSH FS 会劫持文件资源管理器,导致打开文件夹失败、右键菜单异常、远程终端无法启动。VSCode 官方明确不推荐混用。Remote - SSH 自带完整的远程文件树、集成终端、调试器、扩展同步能力,额外插件只会增加故障面。
- SSH FS 的
Mount行为和 Remote - SSH 的Open Folder冲突,后者才是标准流程 - SFTP 插件默认走密码认证,而 Remote - SSH 强依赖密钥登录,配置方式完全不同
- 所谓“增强体验”的插件,90% 的场景下只是掩盖了基础 SSH 配置错误
真正卡住的从来不是插件,而是本地 ssh user@host 能不能通、~/.ssh/config 里 Host 名写对没、私钥权限是不是 600、远程 sshd 有没有跑起来——这些比插件选择重要十倍。


















