答案:通过安装Remote-SSH插件并配置SSH连接,可在VS Code中远程开发。1. 安装插件后通过命令面板连接主机;2. 配置~/.ssh/config设置别名、密钥等信息;3. 连接后自动部署VS Code Server,打开远程文件夹即可开发;4. 建议启用长连接、安装远程插件、使用端口转发,并检查SSH服务与权限以排除故障。

使用 VS Code 的 Remote - SSH 插件,你可以直接在远程服务器上进行开发,就像操作本地项目一样流畅。代码运行在远程主机,编辑体验却完全在本地界面完成。这种模式特别适合需要高性能计算、特定环境配置或团队共用开发机的场景。下面是如何高效使用它的完整说明。
1. 安装与配置 Remote - SSH
打开 VS Code,进入扩展市场(Extensions),搜索 Remote - SSH 并安装。这是微软官方推出的 Remote Development 套件之一。
安装完成后,你会在左侧活动栏看到一个“远程资源管理器”图标(显示器带箭头)。点击它,或者使用快捷键 Ctrl+Shift+P 打开命令面板,输入 Remote-SSH: Connect to Host... 开始连接流程。
2. 配置 SSH 连接信息
VS Code 依赖系统已有的 SSH 配置。你需要确保本地能通过终端 SSH 登录目标服务器。
步骤如下:- 确认已安装 OpenSSH 客户端(Windows 10/11 默认支持,macOS 和 Linux 原生支持)
- 使用终端执行 ssh user@server-ip 测试是否可登录
- 若使用密钥登录,确保私钥已添加到 ssh-agent(可用 ssh-add ~/.ssh/your-key 添加)
- 编辑 ~/.ssh/config 文件,为常用主机设置别名
例如,在 ~/.ssh/config 中添加:
Host myserver
HostName 192.168.1.100
User developer
Port 22
IdentityFile ~/.ssh/id_rsa_work
保存后,VS Code 的 Remote-SSH 就可以直接选择 "myserver" 进行连接。
3. 连接并打开远程项目
在命令面板中选择 Remote-SSH: Connect to Host...,然后选择你配置好的主机名(如 myserver)。
首次连接时,VS Code 会自动在远程服务器上部署一个轻量级的“VS Code Server”。这个过程只需要几秒钟,之后你就能看到远程文件系统。
连接成功后,点击“打开文件夹”(Open Folder),输入路径如 /home/developer/project,即可加载项目。此时所有插件、终端、调试器都运行在远程机器上。
4. 使用技巧与常见问题处理
提升使用效率的一些实用建议:
- 保持 SSH 长连接:在 ~/.ssh/config 中添加 ControlMaster auto 和 ControlPath ~/.ssh/sockets/%r@%h:%p 可避免重复认证
- 安装远程插件:像 Python、Docker、GitLens 等插件需在远程环境下安装才能生效
- 端口转发:远程运行 Web 服务(如 localhost:3000),VS Code 会提示转发端口,点击即可在本地浏览器访问
- 文件同步无需手动操作:所有编辑实时写入远程磁盘,无需额外同步工具
- 断线重连:网络中断后重新连接,工作区状态通常能恢复
如果遇到连接失败,检查以下几点:
基本上就这些。一旦配置完成,你就可以享受在本地编辑器中开发远程代码的高效体验。不复杂但容易忽略的是 SSH 配置的细节和权限设置,提前处理好能省去很多麻烦。










