Remote-SSH扩展实现本地界面远程开发：安装后配置SSH连接与密钥认证，连接后自动部署服务端，支持远程文件操作、终端、调试及扩展；优化建议包括保活设置、清理缓存和复用Git凭据。
vscode 的 remote-ssh 扩展能让你像编辑本地文件一样操作远程服务器上的代码，无需手动上传下载、不用切窗口，真正实现“本地界面 + 远程环境”的无缝开发体验。
安装与基础配置
在 VSCode 扩展市场搜索并安装 Remote - SSH（由 Microsoft 官方维护）。安装后侧边栏会出现远程连接图标（两个重叠的屏幕），点击即可启动。首次使用需确保本地已安装 OpenSSH 客户端（Windows 10/11 可在“设置 → 应用 → 可选功能”中添加；macOS 和 Linux 通常自带）。
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 Remote-SSH: Connect to Host...，然后选择 Add New SSH Host...。输入类似 ssh -p 2222 user@192.168.1.100 的连接串（含端口、用户名、IP），VSCode 会自动写入 ~/.ssh/config 文件。
免密登录是关键一步
每次输密码会打断流程，建议配置 SSH 密钥认证：
- 本地运行 ssh-keygen -t ed25519 生成密钥对（默认保存在 ~/.ssh/id_ed25519）
- 用 ssh-copy-id -p 2222 user@192.168.1.100 将公钥复制到服务器（若不支持该命令，可手动追加 ~/.ssh/id_ed25519.pub 内容到服务器的 ~/.ssh/authorized_keys）
- 确认服务器 /etc/ssh/sshd_config 中 PubkeyAuthentication yes 已启用，并重启 sshd
连接后的工作流很自然
成功连接后，VSCode 会在远程服务器上自动部署一个轻量服务端（无需 root 权限，默认在 ~/.vscode-server），之后所有文件浏览、终端、调试、Git 操作都直接作用于远程文件系统。
你可以：
- 在资源管理器中直接打开远程目录（如 /home/user/project）
- 按 Ctrl+Shift+` 打开的终端就是远程 shell，支持 zsh/bash、conda、docker 等原生命令
- 安装扩展时勾选 Install on SSH: [host]，让 Python、Prettier、ESLint 等在远程生效
- 调试 Python/Node.js 时，断点和变量查看完全基于远程进程，无延迟
小技巧提升稳定性与效率
遇到连接中断、扩展加载慢或路径权限异常？试试这些：
- 在 ~/.ssh/config 中为 Host 添加：ServerAliveInterval 60 和 TCPKeepAlive yes，防超时断连
- 如果远程磁盘空间不足导致 server 启动失败，手动删掉 ~/.vscode-server 并重连
- 想复用本地 Git 凭据（如 GitHub Token），启用 git.sshAuthentication 并确保 core.sshCommand 指向本地 ssh（VSCode 默认走远程 ssh，可能读不到本地密钥代理）
- 大项目可配合 "remote.SSH.useLocalServer": true 设置，减少远程资源占用
基本上就这些。Remote-SSH 不复杂但容易忽略细节，配好一次，后续所有开发都省心省力。
