VS Code Remote SSH 远程开发教程

代码在服务器上跑，本地只留个好看的编辑器界面——VS Code 的 Remote-SSH 扩展就是干这个的：本地界面，远程编译、调试、终端全在服务器上执行，体验和本地开发毫无区别。本教程依据微软官方 VS Code Remote 文档（code.visualstudio.com/docs/remote/ssh）整理。

一、准备：SSH 免密登录

Remote-SSH 依赖 SSH 连接，强烈建议先配好密钥登录（详见本站《SSH 密钥登录与安全加固教程》），避免每次连接输密码。本地确认 ssh user@服务器 能直接进入即可。

二、安装与连接

1. 本地 VS Code 安装扩展 Remote - SSH（微软官方）

2. 按 F1，输入 Remote-SSH: Connect to Host，选 Add New SSH Host

3. 按提示输入 ssh user@服务器IP，保存到配置文件

4. 再次 F1 → Connect to Host，选中这台服务器

首次连接会在服务器上自动安装 VS Code Server（约几十 MB），无需手动操作。连接成功后左下角会显示绿色的 SSH: 服务器名。

三、打开远程项目

连接后点「打开文件夹」，选择服务器上的项目目录（如 /opt/myapp），接下来：

• 资源管理器浏览的是服务器上的文件

• 集成终端是服务器上的 Shell

• 搜索、Git 操作、调试全部在远程执行

四、扩展的"远程模式"

关键概念：扩展分两类。

• UI 扩展（主题、快捷键）：装在本地

• 工作区扩展（Python、ESLint、Debugger）：需要在远程再装一遍——扩展面板里远程连接状态下，按钮显示"在 SSH: xxx 中安装"，点一下即可

Python 项目记得让扩展选择服务器上的解释器（如虚拟环境 .venv，见本站 Python 教程）。

五、配置文件技巧

本地 ~/.ssh/config（Windows 在 C:\Users\你\.ssh\config）里管理多台服务器：

Host dev
    HostName 服务器IP
    User kunkun
    Port 2222
    IdentityFile ~/.ssh/id_ed25519
    ServerAliveInterval 60

之后 VS Code 的主机列表直接显示 dev。ServerAliveInterval 60 每 60 秒发心跳，防断连；ServerAliveCountMax 3 配合可以更抗网络抖动。

六、常用操作

端口自动转发是隐藏福利：远程跑的 Web 服务（如 3000 端口），本地浏览器直接开 localhost:3000 就能看，不用配 Nginx。

七、总结

配好这套流程后，一台低配笔记本 + 一台高配服务器，就是最舒服的开发组合：代码永不落地，环境永不重装。