使用 VS Code Remote-SSH 连接 Linux 服务器：从配置到远程开发

一、前言

在日常开发工作中，我们经常需要连接远程 Linux 服务器，进行代码编写、项目部署、环境配置以及程序调试。

传统的 SSH 终端虽然能够完成基本操作，但在文件管理和代码编辑方面不够直观。VS Code 提供的 Remote-SSH 插件，可以让开发者直接在本地编辑远程服务器上的文件，大幅提升开发效率。

本文将介绍如何使用 VS Code Remote-SSH 插件连接 Linux 服务器。

二、准备工作

在开始之前，需要准备以下内容：

1. 一台正常运行的 Linux 服务器。

2. 本地电脑安装 Visual Studio Code。

3. 安装 Remote-SSH 扩展插件。

4. 获取服务器公网 IP、SSH 端口和登录账号。

5. 确保服务器已经开放 SSH 访问权限。

三、安装 Remote-SSH 插件

打开 VS Code，进入扩展市场，在搜索框输入：

Remote - SSH

找到 Microsoft 官方发布的 Remote-SSH 插件，点击安装。

安装完成后，就可以通过 SSH 配置文件管理远程服务器。

四、配置远程服务器

按下快捷键 Ctrl + Shift + P，打开命令面板，输入：

Remote-SSH: Open SSH Configuration File

选择本地 SSH 配置文件，添加服务器信息：

Host MyServer
    HostName 服务器公网IP
    User root
    Port 22

其中：

• Host：服务器别名，可以自定义。

• HostName：服务器公网 IP 地址。

• User：登录服务器使用的用户名。

• Port：SSH 服务端口，默认通常为 22。

保存配置文件即可。

五、连接远程服务器

再次打开 VS Code 命令面板，输入：

Remote-SSH: Connect to Host

选择刚刚配置的服务器别名。

首次连接时，可能需要确认服务器指纹、选择远程系统类型以及输入登录密码或使用 SSH 密钥进行身份验证。

连接成功后，VS Code 左下角会显示远程服务器名称。

此时就可以直接打开远程服务器上的项目文件夹，进行代码编辑和开发。

六、常见问题及解决方法

1. Connection timed out

通常与网络连接、安全组规则或服务器防火墙有关。可以检查 SSH 端口是否开放，以及服务器是否正常运行。

2. Permission denied

通常表示身份验证失败。需要检查用户名、密码、SSH 密钥以及服务器登录权限。

3. Connection refused

可能是服务器 SSH 服务没有正常运行，或者 SSH 监听端口与配置不一致。

4. 连接成功但无法打开文件夹

可以检查当前登录用户是否具有目标目录的访问权限。

七、总结

VS Code Remote-SSH 为远程开发提供了一种简单、高效的解决方案。通过合理配置 SSH 信息，开发者可以在本地完成远程代码编辑、文件管理和项目调试。

对于经常使用云服务器的开发人员来说，掌握 Remote-SSH 的使用方法，不仅可以减少重复操作，也能够让远程开发流程更加顺畅。

技术学习是一个不断积累的过程。熟悉工具、理解原理，并在实际项目中不断实践，才能真正提高开发效率。