首先安装VS Code及Remote - SSH扩展,配置本地SSH并编辑~/.ssh/config添加主机信息,通过命令面板连接后自动安装远程服务,成功后可直接打开远程项目进行开发。

使用VS Code通过SSH连接远程服务器进行开发,已经成为许多开发者提升效率的标准方式。你可以在本地编辑器中操作远程代码,享受和本地开发几乎一致的体验,包括语法提示、调试、版本控制等功能。以下是配置VS Code通过SSH连接远程服务器的完整流程。
1. 准备工作:安装必要组件
确保你的系统已具备以下条件:
- VS Code 已安装:前往官网下载并安装最新版 VS Code。
- Remote - SSH 扩展已安装:打开 VS Code,进入扩展商店(Ctrl+Shift+X),搜索 “Remote - SSH”,由 Microsoft 发布,点击安装。
- 本地支持 SSH 客户端:Windows 10/11 通常自带 OpenSSH 客户端,macOS 和 Linux 默认支持。可在终端运行 ssh -V 验证是否可用。
- 远程服务器开启 SSH 服务:确保目标服务器正在运行 SSH 服务(默认端口 22),可通过 sudo systemctl status ssh 检查。
2. 配置 SSH 连接信息
你需要将服务器的连接信息写入本地的 SSH 配置文件,方便快速连接。
- 打开终端,编辑 SSH 配置文件:
nano ~/.ssh/config - 添加如下内容(根据实际情况修改):
HostName 192.168.1.100
User your_username
Port 22
IdentityFile ~/.ssh/id_rsa
其中:
- Host:自定义别名,后续在 VS Code 中使用。
- HostName:服务器 IP 或域名。
- User:登录用户名。
- Port:SSH 端口,默认为 22,若更改请对应填写。
- IdentityFile:私钥路径,若使用密码登录可省略。
保存并退出。可先在终端测试:ssh myserver,确认能正常登录。
3. 使用 VS Code 连接远程服务器
一切就绪后,开始在 VS Code 中连接:
- 按下 Ctrl+Shift+P 打开命令面板。
- 输入 “Remote-SSH: Connect to Host…” 并选择。
- 从列表中选择你配置的 myserver。
- 首次连接会弹出新窗口,并提示你选择远程系统的类型(Linux / macOS / Windows)。
- VS Code 会在远程服务器上自动安装 “VS Code Server” 组件,过程无需干预。
连接成功后,界面左下角会显示当前连接的主机名,如 myserver,表示已进入远程工作区。
4. 开始远程开发
连接成功后,你可以像本地一样操作:
- 按 Ctrl+Shift+P 输入 “Open Folder”,选择服务器上的项目路径,例如 /home/your_username/project。
- 打开后即可使用 IntelliSense、Git 管理、调试器等全部功能。
- 所有文件修改都直接作用于远程服务器。
如果需要终端,打开集成终端(Ctrl+`),它默认就是连接到远程服务器的 shell 环境。
基本上就这些。配置一次后,后续只需在命令面板选择主机即可快速重连,高效又稳定。不复杂但容易忽略细节,比如权限问题或SSH密钥格式错误,建议保持私钥权限为 600(chmod 600 ~/.ssh/id_rsa)。搞定之后,本地编辑、远程运行的开发模式会非常顺手。










