VSCode 远程连接 SSH 服务器需安装 Remote - SSH 插件，支持密码和密钥登录。配置涉及添加 SSH Host 或编辑 config 文件设置别名与端口。常见问题如图标缺失可通过命令面板解决，连接失败需检查服务状态及防火墙。连接后可在资源管理器中操作文件并使用远程终端提升效率。
在日常开发 / 运维工作中，VSCode 凭借强大的插件生态和可视化编辑能力，成为远程操作服务器的首选工具。本文将手把手教你通过 VSCode 连接 SSH 服务器，涵盖插件安装、多方式配置连接、密码 / 密钥登录、图标缺失兜底方案全流程，新手也能轻松上手！
在开始前，请确认满足以下条件：
| 环境 / 设备 | 要求说明 |
|---|---|
| 本地机器 | 安装最新版 VSCode（下载地址），支持 Windows/macOS/Linux 系统 |
| 远程服务器 | 1. 开启 SSH 服务（默认端口 22，若修改需记录新端口）；2. 服务器 IP 可正常访问（示例用 <服务器 IP>，替换为你的真实 IP）；3. 拥有服务器登录用户名 + 密码 / 私钥 |
| 网络 | 本地与服务器网络互通（可 ping 通服务器 IP，或确认 22 端口开放） |
VSCode 本身不自带 SSH 连接功能，需安装官方核心插件：
Ctrl+Shift+X/Cmd+Shift+X）；Remote - SSH，找到微软官方发布的「Remote - SSH」插件（作者：Microsoft，标识为「远程服务器 + SSH」样式）；注意：需确保安装的是微软官方版本，避免第三方仿冒插件导致功能异常。
很多用户安装插件后找不到「远程资源管理器」图标，以下提供 3 种兜底入口，任选其一即可：
若 VSCode 打开后显示欢迎页（如截图所示），直接点击「Start」区域下的 「Connect to...」（位于「Clone Git Repository...」下方），即可进入 SSH 连接配置流程。
无论是否显示图标，按快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）打开命令面板，输入 Remote-SSH: Connect to Host...，回车后直接进入连接配置。
若安装插件并重启后，左侧边栏出现「远程资源管理器」图标（样式为「><」左右箭头），点击该图标即可打开 SSH 目标面板；若未显示，无需纠结，直接用入口 1/2 即可。
ssh root@<服务器 IP>ssh root@<服务器 IP> -p 2222config 文件（Windows 路径：C:\Users\你的用户名\.ssh\config；macOS/Linux 路径：~/.ssh/config），点击保存。弹出输入框，输入 SSH 连接基础命令，格式如下：
ssh 用户名@<服务器 IP> -p <端口号>
若需自定义别名、密钥登录、防超时等，手动编辑配置文件更灵活：
Ctrl+Shift+P），输入 Remote-SSH: Open SSH Configuration File...，选择默认的 config 文件；config 文件，VSCode 会自动加载新配置。在打开的 config 文件中，粘贴以下模板并修改参数：
# 自定义连接别名（如 server-211，方便识别）
Host server-211
HostName <服务器 IP> # 服务器真实 IP
User root # 登录用户名（如 root、admin）
Port 22 # SSH 端口，默认 22，修改后同步此处
# 可选：密钥登录（替换为本地私钥路径，注释取消即可生效）
# IdentityFile C:\Users\你的用户名\.ssh\id_rsa # Windows 私钥路径
# IdentityFile ~/.ssh/id_rsa # macOS/Linux 私钥路径
# 可选：防止连接超时（每 60 秒发心跳包）
ServerAliveInterval 60
server-211 或 root@<服务器 IP>）；密钥登录可避免频繁输入密码，且安全性更高，步骤如下：
ssh-copy-id 不可用，打开本地 id_rsa.pub 文件（公钥），复制全部内容；登录服务器，将内容粘贴到 /root/.ssh/authorized_keys 文件（无该文件则新建），并执行 chmod 600 /root/.ssh/authorized_keys 确保权限。config 文件，取消 IdentityFile 行的注释，填写本地私钥路径，保存后重新连接服务器，即可免密码登录。方法 1（推荐）：终端执行以下命令（替换用户名和 IP），自动复制公钥到服务器：
ssh-copy-id root@<服务器 IP>
本地生成密钥对（若已有则跳过）：打开 VSCode 终端（快捷键 Ctrl+），执行以下命令：
ssh-keygen -t rsa -b 4096
按回车默认保存路径（Windows：C:\Users\你的用户名\.ssh\id_rsa；macOS/Linux：~/.ssh/id_rsa），无需设置密钥密码（或按需设置）。
/usr/local），可可视化编辑文件；Ctrl+（反引号），或点击「终端」→「新建终端」，直接执行服务器命令（如 FIO 测试、文件操作）；systemctl status sshd 检查 SSH 服务，未启动则执行 systemctl start sshd；ufw allow 22（Ubuntu/Debian）或 firewall-cmd --add-port=22/tcp --permanent（CentOS）。chmod 600 ~/.ssh/id_rsa）。ServerAliveInterval 60，保存后重新连接。VSCode 连接 SSH 服务器的核心是「安装 Remote - SSH 插件 + 配置连接信息 + 验证登录」，无需纠结「远程资源管理器」图标，通过「欢迎页 Connect to...」或「命令面板」即可完成所有操作。相比纯命令行，VSCode 支持可视化编辑、插件扩展、断点调试等功能，能大幅提升远程开发 / 运维效率。
若你是 Windows 7 等老系统，需先安装 OpenSSH 客户端（或 PuTTY），核心配置逻辑与上述一致，仅需适配本地 SSH 环境即可。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online