使用 VSCode Remote-SSH 可实现高效远程开发，安装扩展后配置 SSH 连接信息，通过密钥登录并优化 KeepAlive 与远程插件，即可在本地操作远程服务器，获得流畅开发体验。
使用 vscode 进行远程开发是现代开发中提升效率的重要方式，尤其适合在本地机器配置较低、目标环境为 linux 服务器或需要统一开发环境的场景。通过 remote-ssh 插件，你可以直接在远程服务器上编辑、运行和调试代码，获得近乎本地的开发体验。
1. 安装与配置 Remote-SSH 扩展
VSCode 的远程开发能力依赖于官方提供的扩展包：
- 打开 VSCode，进入扩展市场（快捷键 Ctrl+Shift+X）
- 搜索并安装 Remote - SSH 扩展（由 Microsoft 提供）
- 安装完成后，侧边栏会出现远程资源管理器图标（左下角绿色按钮）
该扩展基于 SSH 协议连接远程主机，并在远程系统自动部署轻量级服务（vscode server），实现文件访问、终端集成和语言服务等功能。
2. 配置 SSH 连接信息
确保本地已安装 OpenSSH 客户端（Windows 10/11 默认支持，macOS 和 Linux 原生支持）。
- 按下 Ctrl+Shift+P 打开命令面板
- 输入并选择 Remote-SSH: Add New SSH Host
- 输入连接命令，例如：ssh user@192.168.1.100 -p 2222
- 选择保存到哪个 SSH 配置文件（通常为 ~/.ssh/config）
你也可以手动编辑 ~/.ssh/config 文件，添加如下内容：
Host myserver HostName 192.168.1.100 User yourname Port 2222 IdentityFile ~/.ssh/id_rsa_server配置别名后，在 VSCode 中只需选择 “myserver” 即可连接。
3. 建立连接并启动远程会话
- 点击左下角绿色标签 “Open Remote Window”
- 选择 “Connect to Host…” 并选中你的主机别名
- 首次连接时，VSCode 会在远程主机自动下载并安装 vscode server
- 连接成功后，窗口左下角会显示远程标识，如 [SSH: myserver]
此时所有操作（文件浏览、终端、调试、Git 提交等）都在远程执行，本地仅作为界面客户端。
4. 推荐配置与最佳实践
为了获得更高效稳定的远程开发体验，建议进行以下优化：
- 使用 SSH 密钥免密登录：避免重复输入密码，提高连接稳定性。生成密钥对并用 ssh-copy-id 将公钥上传至远程服务器
- 配置 KeepAlive 防止断连：在 ~/.ssh/config 中添加： ServerAliveInterval 60 ServerAliveCountMax 3
- 设置远程工作区首选项：在远程环境中安装常用插件（如 Python、Docker、Pylance），这些插件将在远程运行
- 启用符号链接支持：若项目依赖软链，确保远程系统支持且 VSCode 设置中未禁用
- 合理使用端口转发：通过 VSCode 的端口面板将远程服务（如 localhost:3000）映射到本地浏览器预览
- 定期清理远程服务缓存：长时间使用后，可删除远程用户目录下的 ~/.vscode-server 中旧版本以释放空间
基本上就这些。只要网络稳定、SSH 配置正确，VSCode 的远程开发体验非常流畅，几乎感觉不到是在操作远程机器。关键是把基础设好，尤其是密钥认证和 config 文件管理，后续使用会省心很多。
