首先安装Remote - SSH扩展并配置~/.ssh/config文件,通过F1命令面板连接主机,VSCode将自动部署远程服务端,实现本地化开发体验。

使用VSCode通过SSH连接远程服务器进行开发,是提升工作效率的常用方式。你可以在本地编辑器中操作远程文件,享受语法提示、调试功能和终端集成,就像在本地开发一样。下面详细介绍如何配置SSH连接并使用VSCode进行远程开发。
安装必要组件
要启用远程开发功能,必须先安装以下两个扩展:
- Remote - SSH:这是核心插件,支持通过SSH协议连接远程主机
- (可选)Remote Development 扩展包:包含SSH、WSL和容器支持,一键安装更方便
打开VSCode,进入扩展商店搜索“Remote - SSH”,点击安装即可。
配置SSH连接信息
确保你的本地机器已安装OpenSSH客户端。Windows 10以上版本通常自带,macOS和Linux默认支持。
接下来配置SSH连接参数:
- 按 F1 或 Ctrl+Shift+P 打开命令面板
- 输入并选择 Remote-SSH: Add New SSH Host
- 输入连接命令,格式为:ssh username@server_ip -p port(如端口为22可省略-p部分)
- 选择保存位置,默认为
~/.ssh/config
例如:
Host myserver
HostName 192.168.1.100
User wang
Port 22
建立远程连接
配置完成后,在VSCode左下角点击蓝色按钮或再次打开命令面板选择 Remote-SSH: Connect to Host,然后选择你刚添加的主机名。
专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬
首次连接会弹出新窗口,并提示你输入密码。成功后,VSCode会在远程服务器上自动安装“VS Code Server”组件,用于支持语言服务、调试等功能。
连接成功后,资源管理器左上角会显示当前连接的主机名,如 wang@myserver,表示已进入远程工作区。
常见问题与优化建议
遇到连接失败时,可检查以下几点:
- 确认服务器SSH服务正在运行(
systemctl status sshd) - 防火墙是否放行对应端口
- 用户是否有登录权限
- 本地SSH配置语法是否正确
为免密登录,推荐配置SSH密钥:
ssh-keygen -t rsa -b 4096
ssh-copy-id username@server_ip
之后连接将不再需要手动输入密码,体验更流畅。
基本上就这些。只要网络稳定,VSCode远程开发几乎感觉不到延迟,特别适合管理云服务器或进行跨平台项目开发。不复杂但容易忽略细节,比如路径一致性或权限设置,注意这些就能顺畅使用。








