【VSCode】SSH远程服务器连接全攻略

目录

一、为什么选择 VSCode 连接 SSH 远程服务器

二、准备工作

（一）确保服务器开启 SSH 服务

（二）本地安装 VSCode

（三）安装 Remote - SSH 插件

三、具体连接步骤

（一）添加服务器连接配置

（二）连接到远程服务器

四、实现免密登录

（一）生成 SSH 密钥对

（二）将公钥添加到远程服务器

（三）验证免密登录

五、常见问题及解决方案

（一）连接失败问题

（二）权限问题

（三）其他问题

六、总结

---

一、为什么选择 VSCode 连接 SSH 远程服务器

在软件开发和系统管理的过程中，远程连接服务器进行代码编写和调试是一项常见的任务。以往，我使用过如 Xshell、Putty 等传统的 SSH 连接工具，它们在执行命令和文件传输方面表现尚可，但在进行代码开发时却存在诸多不便。例如，在本地编写代码后，需要手动将文件上传到服务器，这个过程繁琐且容易出错；而且在服务器上运行程序时，调试信息的查看也不够直观和便捷。

直到我发现了 VSCode 连接 SSH 远程服务器的方式，它彻底改变了我的开发体验。VSCode 不仅拥有简洁美观的界面和强大的代码编辑功能，还通过插件扩展实现了与远程服务器的无缝连接，让我可以直接在本地编辑远程服务器上的文件，就像操作本地文件一样方便。这种方式大大提高了开发效率，减少了因文件传输和环境差异带来的问题。

二、准备工作

在使用 VSCode 连接 SSH 远程服务器之前，我们需要做好一些准备工作，以确保连接的顺利进行。

（一）确保服务器开启 SSH 服务

1. 检查 SSH 服务状态：如果你使用的是 Linux 系统，可以通过以下命令检查 SSH 服务是否已经开启。在服务器的终端中输入sudo systemctl status sshd（对于使用 systemd 的系统）或sudo service sshd status ，如果 SSH 服务已经启动，你会看到类似如下的信息：

● sshd.service - OpenSSH server daemon

Loaded: loaded (/lib/systemd/system/sshd.service; enabled; vendor preset: enabled)

Active: active (running) since Tue 2024-12-10 10:15:30 CST; 3 days ago

Docs: man:sshd(8)

man:sshd_config(5)

Main PID: 1234 (sshd)

Tasks: 1 (limit: 4915)

Memory: 3.5M

CGroup: /system.slice/sshd.service

└─1234 sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups

如果服务未启动，信息中会显示Active: inactive (dead) 。

2. 开启 SSH 服务：若 SSH 服务未启动，我们可以使用命令来启动它。同样在服务器终端输入sudo systemctl start sshd（systemd 系统）或sudo service sshd start ，执行命令后，再次检查服务状态，确保 SSH 服务已成功启动。另外，还可以设置 SSH 服务开机自启，以方便后续使用，使用命令sudo systemctl enable sshd即可。

（二）本地安装 VSCode

1. 下载 VSCode：打开你的浏览器，访问 VSCode 官方下载地址：https://code.visualstudio.com/Download 。在该页面，你可以根据自己的操作系统选择对应的安装包，如 Windows 系统可选择 Windows 用户安装程序（x64 或 Arm64） ，Mac 系统选择适用于 macOS 10.15 + 的版本。

1. 安装 VSCode：下载完成后，找到下载的安装包并双击运行。以 Windows 系统为例，安装过程中，首先会弹出许可协议界面，阅读并同意协议后点击 “下一步”；接着选择安装路径，你可以保持默认路径，也可以点击 “浏览” 选择其他位置，然后继续点击 “下一步”；在 “选择开始菜单文件夹” 步骤也可保持默认设置；