VSCode 远程连接 SSH 服务器教程
在日常开发 / 运维工作中,VSCode 凭借强大的插件生态和可视化编辑能力,成为远程操作服务器的首选工具。本文介绍如何通过 VSCode 连接 SSH 服务器,涵盖插件安装、多方式配置连接、密码 / 密钥登录、图标缺失兜底方案全流程。
一、前置条件
在开始前,请确认满足以下条件:
| 环境 / 设备 | 要求说明 |
|---|---|
| 本地机器 | 安装最新版 VSCode,支持 Windows/macOS/Linux 系统 |
| 远程服务器 | 1. 开启 SSH 服务(默认端口 22,若修改需记录新端口);2. 服务器 IP 可正常访问;3. 拥有服务器登录用户名 + 密码 / 私钥 |
| 网络 | 本地与服务器网络互通(可 ping 通服务器 IP,或确认 22 端口开放) |
二、步骤 1:安装 Remote - SSH 插件
VSCode 本身不自带 SSH 连接功能,需安装官方核心插件:
- 打开 VSCode,点击左侧边栏的「扩展」图标(快捷键
Ctrl+Shift+X/Cmd+Shift+X); - 在扩展搜索框中输入
Remote - SSH,找到微软官方发布的「Remote - SSH」插件; - 点击「安装」按钮,安装完成后无需重启(若后续图标不显示再重启)。
注意:需确保安装的是微软官方版本,避免第三方仿冒插件导致功能异常。
三、步骤 2:SSH 连接入口(解决「远程资源管理器」图标缺失问题)
很多用户安装插件后找不到「远程资源管理器」图标,以下提供 3 种兜底入口,任选其一即可:
入口 1:欢迎页「Connect to...」(最直接,推荐)
若 VSCode 打开后显示欢迎页,直接点击「Start」区域下的 「Connect to...」,即可进入 SSH 连接配置流程。
入口 2:命令面板(万能兜底)
无论是否显示图标,按快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)打开命令面板,输入 Remote-SSH: Connect to Host...,回车后直接进入连接配置。
入口 3:远程资源管理器图标(若显示)
若安装插件并重启后,左侧边栏出现「远程资源管理器」图标(样式为「><」左右箭头),点击该图标即可打开 SSH 目标面板;若未显示,无需纠结,直接用入口 1/2 即可。
四、步骤 3:配置 SSH 连接信息
方式 1:可视化配置(新手推荐)
- 通过上述任意入口进入「SSH 连接配置」后,选择「Add New SSH Host...」;
- 示例(默认 22 端口):
ssh 用户名@服务器 IP - 示例(自定义端口,如 2222):
ssh 用户名@服务器 IP -p 2222
- 示例(默认 22 端口):
- 按回车后,VSCode 会提示「选择要保存配置的文件」,选择默认的
config文件(Windows 路径:C:\Users\用户名\.ssh\config;macOS/Linux 路径:~/.ssh/config),点击保存。
弹出输入框,输入 SSH 连接基础命令,格式如下:
ssh 用户名@服务器 IP -p 端口号

