首先安装 Remote - SSH 插件,然后配置本地 SSH 文件添加主机信息,通过命令面板连接主机,VSCode 会自动部署远程服务,连接后可直接在远程环境编辑代码、运行终端,支持端口转发等高级设置,适合多场景开发运维。

在 VSCode 中管理远程连接主要依赖于 Remote - SSH 插件,它让你能通过 SSH 连接到远程服务器、容器或虚拟机,并像本地一样编辑和运行代码。以下是具体操作方法。
安装并配置 Remote - SSH 插件
打开 VSCode,进入扩展市场(左侧活动栏的方块图标),搜索 Remote - SSH 并安装。这是微软官方提供的插件,支持跨平台使用。
安装完成后,按下 F1 或 Ctrl+Shift+P 打开命令面板,输入 Remote-SSH: Connect to Host,后续就可以选择已配置的远程主机进行连接。
添加远程主机到配置文件
VSCode 使用本地的 SSH 配置文件来管理远程主机信息。你可以手动编辑这个文件:
- 配置文件路径通常是:~/.ssh/config(macOS/Linux)或 C:\Users\你的用户名\.ssh\config(Windows)
- 添加一个主机配置示例:
HostName 192.168.1.100
User yourname
Port 22
IdentityFile ~/.ssh/id_rsa
保存后,在 VSCode 命令面板中再次使用 Connect to Host,就能看到 myserver 出现在列表中。
连接并管理远程会话
选择目标主机后,VSCode 会在左下角显示连接状态,首次连接会自动在远程机器上部署 VS Code Server(无需手动操作)。
连接成功后,整个工作区变为远程环境,你可以在远程系统中打开文件夹、运行终端、调试程序,就像在本地一样。
切换或断开连接也很简单:
- 点击左下角当前主机名,可选择重新连接、删除连接或断开
- 断开后仍保留配置,下次可快速重连
- 右键主机名还能设置是否自动转发端口或启用 X11 转发等高级选项
基本上就这些。只要 SSH 能通,VSCode 就能连上,适合开发、运维多种场景。注意保持本地 SSH 密钥安全,避免明文密码登录。不复杂但容易忽略细节。










