
使用 vscode 的远程 SSH 插件可以在本地编辑器中连接并开发远程服务器上的项目,极大提升跨环境开发效率。整个配置过程不复杂,只要网络和权限设置正确,基本一次就能成功。
安装 Remote – SSH 插件
打开 VSCode,在左侧扩展面板中搜索 Remote – SSH,由 microsoft 官方提供。安装完成后重启编辑器。
安装后,左下角会出现一个“>
配置 SSH 连接信息
确保本地已安装 OpenSSH 客户端(Windows 10/11 一般自带,macOS 和 Linux 原生支持)。在 VSCode 中按下 F1 或 Ctrl+Shift+P 打开命令面板,输入 “Remote-SSH: Connect to Host”,选择 “Add New SSH Host”。
输入连接命令,格式如下:
ssh username@hostname -p port
例如:
ssh john@192.168.1.100 -p 22
之后会提示选择 SSH 配置文件,通常选默认的 ~/.ssh/config。VSCode 会将该主机记录写入此文件,便于后续管理。
测试连接并登录
再次通过命令面板选择 “Remote-SSH: Connect to Host”,然后选择你刚添加的主机。VSCode 会打开一个新窗口,尝试通过 SSH 连接到目标机器。
首次连接会提示你确认服务器指纹,选择 yes。接着输入用户密码,或使用已配置的私钥自动认证。
如果私钥有密码,系统会弹出输入框要求输入 passphrase。建议使用 ssh-agent 管理密钥避免重复输入。
连接成功后,VSCode 状态栏会显示远程标识,左侧资源管理器将加载远程文件系统。
优化远程开发体验
连接成功后,可在远程环境中直接打开项目目录。VSCode 会自动在远程安装“VS Code Server”,用于支持语法检查、智能补全等功能。
常见优化建议:
- 在 ~/.ssh/config 中为常用主机设置别名、端口、密钥路径,简化连接
- 使用 SSH 密钥认证代替密码,提升安全性和便利性
- 配置免密登录:将本地公钥(~/.ssh/id_rsa.pub)内容追加到远程服务器的 ~/.ssh/authorized_keys
- 若网络不稳定,可在 SSH 配置中添加 KeepAlive 参数防止断连
基本上就这些。只要 SSH 能通,VSCode 远程开发几乎零延迟,像本地一样流畅。配置一次,长期受益。