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%\.ssh\config）
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 很快就会变成瓶颈。
