VSCode通过Remote-SSH插件实现本地编辑、远程运行,安装插件后配置SSH主机并连接,即可打开远程目录进行全功能开发;扩展需在远程安装,终端与调试均在远端执行。

VSCode通过Remote-SSH插件,能让你像编辑本地文件一样流畅地编辑远程服务器上的代码,所有运算在远端执行,本地只负责显示和输入。
安装并配置Remote-SSH插件
打开VSCode扩展市场(Ctrl+Shift+X),搜索“Remote-SSH”,安装由Microsoft官方发布的插件。安装后重启VSCode,左侧活动栏会出现远程资源管理器图标(两个重叠的屏幕)。点击它,选择“Connect to Host...”,首次使用需先配置SSH主机。
你可以直接编辑~/.ssh/config文件添加主机条目,例如:
Host my-server
HostName 192.168.1.100
User ubuntu
IdentityFile ~/.ssh/id_rsa
保存后,VSCode会自动识别该主机,后续连接只需选中即可。
建立SSH连接并打开远程项目
点击“Connect to Host...”,选择已配置的主机名(如my-server),VSCode会尝试用SSH登录。首次连接可能提示确认服务器指纹,输入yes继续。登录成功后,会自动在远程服务器上部署VSCode Server(无需手动安装)。
连接建立后,点击“Open Folder”,输入远程路径(如/home/ubuntu/myproject),即可打开远程目录,所有文件操作、终端、调试、Git等都运行在远程环境。
常用技巧与注意事项
- 远程终端默认复用SSH会话,按Ctrl+Shift+`可快速打开;终端里执行的命令(如npm run dev)完全在远程运行
- 扩展分本地与远程:有些扩展(如Python、Prettier)需在远程安装才生效,VSCode会提示“Install on SSH: my-server”
- 若连接失败,检查SSH服务是否运行(sudo systemctl status ssh)、防火墙是否放行22端口、密钥权限是否为600(chmod 600 ~/.ssh/id_rsa)
- 支持多窗口分别连接不同服务器,每个窗口独立维护自己的远程会话
不复杂但容易忽略:VSCode Remote-SSH本质是把编辑器前端本地化,后端全跑在远端——你写的每一行代码、每次保存、每个断点,都是真正在目标服务器上发生。










