<p>使用 vscode Remote-ssh 可高效实现本地编辑、远程运行。安装 microsoft 提供的 Remote – SSH 扩展后,通过左侧远程资源管理器添加主机,输入 ssh user@ip 并保存配置;推荐使用 ssh-keygen 生成密钥对,配合 ssh-copy-id 部署公钥,提升安全性与连接便利性;连接成功后,VSCode 自动在远程部署服务端,支持远程文件管理、终端操作、断点调试及插件扩展(如 python),开发体验接近本地;注意关闭不必要的自动同步功能以优化性能。</p>
使用 vscode 进行远程 ssh 开发是提升开发效率的常用方式,尤其适合在本地编辑代码、远程服务器运行程序的场景。通过 remote-ssh 插件,你可以像操作本地项目一样管理远程主机上的文件和终端。
安装并配置 Remote-SSH 扩展
VSCode 本身不自带远程功能,需依赖官方扩展:
- 打开 VSCode,进入扩展商店(快捷键 Ctrl+Shift+X)
- 搜索 Remote – SSH 并安装(由 Microsoft 提供)
- 安装完成后,左侧活动栏会出现远程资源管理器图标
连接远程服务器
连接前确保你有目标服务器的 IP 地址、用户名和密码(或密钥)。
- 点击左下角绿色的“<”图标,选择 Connect to Host…
- 选择 Add New SSH Host
- 输入连接命令,例如:ssh user@192.168.1.100
- 选择保存到哪个 SSH 配置文件(通常为默认的 ~/.ssh/config)
- 之后会在远程资源管理器中看到新增的主机条目
点击该主机即可开始连接。首次连接会提示选择平台(linux / macOS / windows),然后自动安装 VSCode Server 到远程主机。
使用私钥登录(推荐)
比起密码,使用 SSH 密钥更安全且免重复输入:
- 本地生成密钥对:ssh-keygen -t rsa -b 4096
- 将公钥上传到远程:ssh-copy-id user@192.168.1.100
- 修改 ~/.ssh/config 文件,指定私钥路径:
Host MyServer HostName 192.168.1.100 User user IdentityFile ~/.ssh/id_rsa_myserver
后续连接将自动使用密钥认证。
开发体验与功能
成功连接后,VSCode 界面右下角显示当前连接的主机名,此时所有操作都在远程执行。
- 打开远程目录:点击“Open Folder”浏览远程文件系统
- 编辑文件:支持语法高亮、智能补全、跳转定义等全部本地功能
- 集成终端:Ctrl+` 打开的终端直接运行在远程主机上
- 调试支持:可配置 launch.json 在远程断点调试程序
- 扩展隔离:部分插件需安装在远程端才能生效(如 Python、Pylint)
基本上就这些。只要网络稳定,远程开发体验几乎和本地无异。注意关闭不需要的自动同步功能,避免频繁读写影响性能。


