VSCode怎样连接远程服务器进行开发与部署？【教程】

vscode通过Remote-ssh扩展实现远程开发，前端本地运行、后端在远程机器执行；部署需单独配置，不依赖该插件。

vscode 本身不直接“连接”远程服务器，而是通过 remote - ssh 扩展实现远程开发——它把 vscode 的前端界面留在本地，后端（文件系统、终端、调试器、语言服务）运行在远程机器上。部署是另一件事，需单独配置，不能指望插件自动完成。

装对扩展：只认 Remote - SSH，别装错名字

VSCode 官方 Remote 开发套件包含三个插件：Remote - SSH、Remote - Containers、Remote - WSL。你只需要第一个。搜索时务必核对作者是 microsoft，全名是 Remote - SSH（不是 SSH FS、SSH Remote 或其他仿名插件）。装错会导致无法加载远程窗口、Ctrl+Shift+P 里搜不到 Remote-SSH: Connect to Host...。

• 装完后重启 VSCode（部分版本需手动重载窗口）
• 确保本地已安装 OpenSSH 客户端（windows 10/11 可在“可选功能”中启用；macos 和 linux 一般自带）
• 执行 ssh -V 能输出版本号，才算环境就绪

ssh_config 文件位置与基本写法（Linux/macOS 在 ~/.ssh/config，Windows 在 %USERPROFILE%.sshconfig）

VSCode 的 Remote – SSH 依赖系统级的 SSH 配置文件，而不是在 ui 里填 IP 和密码。手写配置比每次输更可靠，也支持密钥、端口、用户等细粒度控制。

• 配置示例（保存为 ~/.ssh/config）：

Host myserver     HostName 192.168.1.100     User ubuntu     Port 2222     IdentityFile ~/.ssh/id_rsa_prod

• Host 是你在 VSCode 里选择的别名（下拉列表中显示的名字）
• IdentityFile 必须是私钥路径，且权限需为 600（Linux/macOS 执行 chmod 600 ~/.ssh/id_rsa_prod）
• 如果服务器禁用密码登录（推荐），但没配好密钥，会卡在 “Waiting for server to start…” 且无报错提示

首次连接失败的三个高频原因

连不上不是插件问题，大概率是 SSH 层面的配置或权限没到位。

• Permission denied (publickey)：说明服务器拒绝了你的密钥。检查 IdentityFile 是否指向正确的私钥，且对应公钥已追加到远程 ~ubuntu/.ssh/authorized_keys
• “Could not establish connection to …” + 空白弹窗：常见于远程机器没装 curl 或 tar（VSCode 远程服务端需要这两个命令解压并启动服务）
• 连接成功但打开文件夹报 Command failed: stat …：说明远程用户对目标目录无读取权限，或者路径含中文/空格（尽量避免）

部署不是远程开发的附带功能，得自己串 CI 或写脚本

Remote – SSH 让你“在远程写代码”，但它不会帮你把代码推到生产环境、重启服务或跑测试。部署要另起炉灶：

• 简单场景：在 VSCode 内置终端里手动执行 git pull && npm install && pm2 restart app
• 进阶做法：用 tasks.json 定义一键部署任务，绑定快捷键；或配合 github Actions / jenkins 触发远程部署脚本
• 注意：不要在远程开发窗口里直接编辑 /var/www 等系统目录——权限不足、SELinux 限制、编辑器缓存冲突都可能让你改了却看不到效果

真正麻烦的从来不是连上服务器，而是搞清哪段逻辑该在本地跑、哪段必须在远程跑、哪段该交给自动化流程——尤其是当项目涉及构建产物同步、环境变量注入、数据库迁移时，手动连 SSH 很快就会变成瓶颈。