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