VSCode 的 Remote - SSH 扩展支持无缝编辑远程文件。安装后配置 SSH 主机、密钥认证，连接并打开远程文件夹，即可实时编辑、调试、使用终端与 Git；注意权限、安全及端口转发等技巧。
VSCode 的远程资源管理器（Remote - SSH 扩展）让你像编辑本地文件一样打开、修改、保存远程服务器上的文件，无需手动下载/上传或使用命令行编辑器。
安装并配置 Remote - SSH 扩展
在 VSCode 扩展市场中搜索 Remote - SSH（官方出品，图标为锁形），点击安装。重启 VSCode 后，左侧活动栏会出现远程资源管理器图标（两个重叠的屏幕）。点击它，选择 Connect to Host…，然后添加你的 SSH 主机配置：
- 确保本地已生成 SSH 密钥（
ssh-keygen），并将公钥（如id_rsa.pub）追加到服务器的~/.ssh/authorized_keys - 在 VSCode 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入 Remote-SSH: Add New SSH Host - 输入类似
user@192.168.1.100或user@server.example.com的地址，选择默认配置文件（如~/.ssh/config）保存
连接并打开远程文件夹
配置完成后，在远程资源管理器中点击目标主机旁的 ➕ 图标，VSCode 会通过 SSH 连接并在远程服务器上启动一个轻量级服务端（VS Code Server）。连接成功后，点击 Open Folder，输入路径（如 /var/www/html 或 ~/project），即可加载远程目录结构。
- 所有文件操作（新建、重命名、删除、保存）实时作用于远程服务器，无需额外同步
- 支持完整语言支持（语法高亮、智能提示、调试）、Git 集成和终端（自动切换为远程 shell）
- 若首次连接卡在“Installing VS Code Server”，检查服务器是否能访问 GitHub（用于下载 server 二进制），或手动离线安装
高效协作与常见技巧
多个项目可分别保存连接配置；常用操作可通过命令面板快速触发：
- 按
Ctrl+Shift+P输入 Remote-SSH: Connect to Host… 快速切换服务器 - 右键远程文件 → Copy Relative Path 或 Reveal in Explorer 提升定位效率
- 在远程窗口中打开集成终端（
Ctrl+`），执行npm run dev等命令，输出直接显示在 VSCode 内 - 如需图形化应用（如浏览器预览），配合 Remote - SSH: Forward a Port 将远程端口映射到本地
权限与安全性提醒
VSCode 以你登录用户的权限读写文件，不会自动提权。编辑系统关键路径（如 /etc/nginx/）时，需确保该用户有对应权限，或改用 sudo 配合 visudo 授权特定命令（不推荐直接用 root 连接）。
- 避免在
~/.ssh/config中明文存储密码；优先使用密钥认证 + passphrase - 连接信息（主机、端口、用户）保存在本地配置文件中，注意保护
~/.ssh/目录权限（chmod 700 ~/.ssh） - 断开连接后，远程的 VS Code Server 默认会保留一段时间（可配置自动清理），如需立即终止，可在命令面板运行 Remote-SSH: Kill VS Code Server on Host
