VS Code 使用 SSH 连接服务器教程

前置条件

确认服务器系统版本

• 服务器建议使用 Ubuntu 20.04 或更高版本。
• 登录服务器后先执行版本自查命令，确认系统版本满足要求。

这一步在服务器终端里执行，不是在本地 Windows PowerShell 里执行。

lsb_release -a
# 如果没有 lsb_release，也可以用：
cat /etc/os-release

打开入口

在 VS Code 里打开远程连接入口

• 打开 VS Code 后，可以点击欢迎页里的“连接到...”。
• 也可以点击左下角蓝色远程状态按钮，进入同一个远程连接菜单。

已有主机

选择“连接到主机...”

• 在远程窗口菜单里选择“连接到主机...”。
• 如果之前已经保存过 SSH 主机，下一步会直接出现主机列表。

选择或新增

连接已保存主机，或添加新的 SSH 主机

• 已经保存过的主机会显示在列表里，选中主机即可开始连接。
• 第一次使用时，选择“添加新的 SSH 主机...”。需要手动改配置时，选择“配置 SSH 主机...”。

让 Codex 填配置

把服务器信息整理成 .ssh/config

• Windows 本地通常编辑 C:\Users\你的 Windows 用户名\.ssh\config；macOS / Linux 通常编辑 ~/.ssh/config。
• 可以直接在 Codex 里发送下面这种指令，让它帮你生成 SSH 配置。

VS Code Remote-SSH 连接时主要读取 Host、HostName、User、Port 这几项。

这是我的主机，帮我填写 ./ssh/config 文件：
主机名：lab-linux-18
IP：xxx.xxx.xxx.xxx
用户名：xxxx
SSH 端口：xxxx
Win远程：xxx.xxx.xxx.xxx:xxxx
ftp-ssh：xxx.xxx.xxx.xxx:xxxx

Host lab-linux-18
  HostName xxx.xxx.xxx.xxx
  User xxxx
  Port xxxx

输入密码

输入 SSH 密码并等待 VS Code Server 初始化

• 选择主机后，VS Code 会在顶部弹出密码输入框。
• 输入服务器密码后按 Enter。首次连接会自动安装和初始化 VS Code Server，等待底部提示完成即可。

连接完成

连接成功后点击“打开文件夹”

• 左侧资源管理器会显示“已连接到远程”。
• 点击“打开文件夹”，准备选择服务器上的项目目录。

选择目录

从 /home/xxxx 开始选择远程文件夹

• 文件夹选择器显示的是服务器上的路径，不是本地电脑路径。
• 通常先进入 /home/xxxx，再选择自己的项目目录。

打开项目

进入项目目录后点击确认

• 进入项目目录后，确认路径正确，再点击“确定”。
• 如果项目还没有创建，可以先选中父目录，进入后再用 VS Code 终端创建文件夹。

开始工作

在本地 VS Code 里远程编辑和运行代码

• 打开远程文件夹后，左侧资源管理器、编辑器、终端都在操作服务器上的文件。
• 之后就可以像本地项目一样写代码、运行命令、提交 Git，只是实际执行环境在远程 Ubuntu 服务器上。