VS Code Remote - SSH：连接远程服务器进行开发的终极指南

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

VS Code Remote - SSH：连接远程服务器进行开发的终极指南

2025-12-04

浏览次数：次

返回列表

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

vs code remote - 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）。

星辰Agent

科大讯飞推出的智能体Agent开发平台，助力开发者快速搭建生产级智能体

378 查看详情星辰Agent

首次连接时，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 会提示转发端口，点击即可在本地浏览器访问
文件同步无需手动操作：所有编辑实时写入远程磁盘，无需额外同步工具
断线重连：网络中断后重新连接，工作区状态通常能恢复