使用VSCode通过Remote-SSH插件远程开发,需本地安装VSCode和SSH客户端,远程服务器开启SSH服务,并配置~/.ssh/config文件添加主机信息,如Host、HostName、User等;通过远程资源管理器连接目标主机,首次连接选择系统类型,确保私钥权限为600,成功后VSCode自动部署远程服务;可打开远程文件夹并使用IntelliSense、Git、终端等功能;建议配置SSH密钥免密登录,在~/.ssh/config中添加ServerAliveInterval和TCPKeepAlive保持连接稳定,按需在远程端安装语言扩展,并在项目中使用.vscode/settings.json设置远程专属配置,实现高效稳定的远程开发体验。

使用VSCode通过SSH远程连接服务器进行开发,是一种高效、灵活的编码方式。尤其适合需要在远程Linux服务器上调试程序或维护项目的场景。借助Remote-SSH插件,你可以在本地编辑器中操作远程文件,享受和本地开发几乎一致的体验。
安装必要组件
要实现远程开发,首先要确保本地和远程环境都满足基本条件:
- 本地安装VSCode:前往官网下载并安装最新版Visual Studio Code
- 安装Remote-SSH扩展:打开VSCode,在扩展市场中搜索“Remote - SSH”并安装(由Microsoft提供)
- 本地支持SSH客户端:Windows 10及以上通常自带OpenSSH客户端,macOS和Linux默认支持。可通过终端运行ssh -V验证是否可用
- 远程服务器开启SSH服务:确保目标服务器已安装并运行OpenSSH服务(如Ubuntu/Debian使用sudo systemctl status ssh检查)
配置SSH连接信息
为了让VSCode顺利连接远程主机,需先配置SSH连接参数:
- 打开VSCode左侧活动栏的“远程资源管理器”图标,点击“SSH Targets”下的“+”添加新主机
- 输入连接命令,例如:ssh username@hostname -p port(若使用非标准端口)
- 该操作会自动修改~/.ssh/config文件,也可手动编辑此文件添加如下内容:
保存后,即可在VSCode的远程资源管理器中看到“myserver”主机名。
建立连接并打开远程项目
点击刚刚添加的主机名,VSCode会弹出一个新窗口开始连接流程:
- 首次连接时会提示选择远程系统的类型(Linux/macOS/Unix),选择对应项以正确加载开发环境
- 如果使用密钥认证,请确保私钥权限设置合理(chmod 600 ~/.ssh/id_rsa)
- 连接成功后,VSCode会在远程服务器上自动部署一个轻量级的“VS Code Server”用于文件访问、调试等支持
- 按执行“Remote-SSH: Open Folder”命令,输入路径如/home/devuser/project
此时编辑器已加载远程目录,可正常使用IntelliSense、Git、终端等功能。
优化使用体验
为提升稳定性和效率,建议进行以下设置:
- 使用SSH密钥免密登录:生成密钥对并将公钥放入远程服务器~/.ssh/authorized_keys
- 保持连接稳定:在~/.ssh/config中添加:
- 配置远程扩展:部分语言支持需在远程端安装扩展(如Python、Pylance),VSCode会提示自动安装到远程环境
- 使用远程工作区设置:项目根目录下创建.vscode/settings.json,定义远程专属配置
基本上就这些。一旦配置完成,每次只需从远程资源管理器选择主机即可快速进入开发状态,无需反复上传文件或切换终端。整个过程不复杂但容易忽略细节,比如权限问题或网络限制,只要基础SSH通了,VSCode远程开发就能顺畅运行。










