VS Code Remote-SSH 教程：本地界面，远程开发

VS Code Remote SSH 远程开发教程代码在服务器上跑，本地只留个好看的编辑器界面——VS Code 的 Remote-SSH 扩展就是干这个的：本地界面，远程编译、调试、终端全在服务器上执行，体验和本地开发毫无区别。本教程依据微软官方 VS Code Remote 文档（code.visualstudio.com/docs/remote/ssh）整理。一、准备：SSH 免密登录 Remote-SSH 依赖 SSH 连接，强烈建议先配好密钥登录（详见本站《SSH 密钥登录与安全加固教程》），避免每次连接输密码。本地确认 ssh user@服务器 能直接进入即可。二、安装与连接本地 VS Code 安装扩展 Remote - SSH（微软官方）按 F1，输入 Remote-SSH: Connect to Host，选 Add New SSH Host 按提示输入 ssh user@服务器IP，保存到配置文件再次 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 配合可以更抗网络抖动。六、常用操作需求做法断开连接 F1 → Remote-SSH: Close Remote Connection（服务器进程保留）本地↔远程传文件远程资源管理器里直接拖拽/右键下载查看远程端口服务连接后自动转发，浏览器访问 localhost:端口 即可换新服务器同样的流程，Add New SSH Host 即可端口自动转发是隐藏福利：远程跑的 Web 服务（如 3000 端口），本地浏览器直接开 localhost:3000 就能看，不用配 Nginx。七、总结需求做法连服务器 Remote-SSH 扩展 + SSH 免密打开项目连接后"打开文件夹" 装远程扩展扩展面板点"在 SSH 中安装" 多服务器管理 ~/.ssh/config 访问远程 Web 自动端口转发到 localhost 配好这套流程后，一台低配笔记本 + 一台高配服务器，就是最舒服的开发组合：代码永不落地，环境永不重装。