vscode通过remote-ssh插件实现远程开发的核心步骤如下:一、安装remote-ssh插件,在扩展界面搜索并安装由微软发布的remote-ssh插件,安装后左下角会显示远程连接按钮;二、配置ssh连接信息,在本地编辑~/.ssh/config文件,添加host、hostname、user及identityfile等参数以定义服务器连接信息;三、连接远程服务器,点击远程按钮或使用快捷命令选择目标主机进行连接,首次连接需确认信任,成功后即可像本地一样操作远程代码和终端;四、处理常见问题,如私钥权限错误可通过chmod 600修改权限解决,远程插件需在远程部分重新安装。整个流程简单顺畅,关键在于正确配置ssh连接和密钥权限。

VSCode 实现远程开发非常方便,尤其是通过 Remote - SSH 插件连接云服务器,几乎可以当作本地开发一样使用。整个流程其实不复杂,核心是配置好 SSH 连接和密钥。

一、安装 Remote - SSH 插件
要实现远程开发,首先需要在 VSCode 中安装官方插件 Remote - SSH。这个插件由微软官方维护,功能稳定。
- 打开 VSCode,点击左侧活动栏的扩展图标(或按
Ctrl+Shift+X) - 搜索 “Remote - SSH”
- 找到由 Microsoft 发布的那一个,点击安装
安装完成后,你会在左下角看到一个类似“Open a Remote Window”的按钮,说明插件已经生效。

二、配置 SSH 连接信息
安装完插件后,下一步就是配置 SSH 连接信息。这一步的关键在于写好 ~/.ssh/config 文件。
-
在本地终端运行以下命令打开配置文件:

code ~/.ssh/config
或者直接用文本编辑器打开。
-
添加如下格式的内容(根据你的云服务器信息修改):
Host myserver HostName 123.45.67.89 User ubuntu IdentityFile ~/.ssh/id_rsa
其中:
-
Host是你给服务器起的别名,比如myserver -
HostName是服务器 IP 地址 -
User是登录用户名,例如 Ubuntu 镜像通常是ubuntu -
IdentityFile是私钥路径,如果你用的是默认密钥,可能可以省略这一行
保存后就可以通过这个别名连接了。
三、连接远程服务器并开始开发
配置好之后,就可以通过 VSCode 直接连接远程服务器了。
- 点击左下角的绿色远程连接按钮(或按
Ctrl+Shift+P输入 “Remote-SSH: Connect to Host”) - 选择你刚才配置好的主机名,比如
myserver - 第一次连接时会提示你是否信任该主机,选择“Continue”
- 成功连接后,VSCode 会自动在远程服务器上下载并安装一个轻量级的 Server 组件
- 安装完成后,你可以像本地一样打开远程目录、编辑代码、运行终端等
注意:如果连接失败,检查一下 SSH 密钥权限是否正确(一般应为 600),以及服务器是否开放了 22 端口。
四、一些常见问题和小技巧
私钥权限不对导致连接失败
- 错误提示可能是 “Bad owner or permissions on ~/.ssh/config”
-
解决方法:确保私钥权限是 600,可以用以下命令修复:
chmod 600 ~/.ssh/id_rsa
如何在远程环境中安装插件?
- 默认情况下,插件是安装在本地的。但有些插件也支持远程安装。
- 在远程连接状态下,打开扩展界面,可以看到插件分为“本地已安装”和“远程:SSH - 当前主机”两个部分。
- 如果你想在远程环境使用某个插件,记得在远程那一栏里重新安装一次。
修改远程开发的工作目录
基本上就这些步骤。虽然看起来有点多,但实际操作下来也就几分钟的事。关键是把 SSH 配置弄清楚,后面就能无缝开发了。










