VS Code 远程开发的配置流程

原创于 2025-05-15 10:12:33 发布

· 1.2k 阅读

8 ·

版权

文章标签：

#vscode

一、基础环境准备

安装 VS Code 与插件
• 下载最新版 VS Code（官网：https://code.visualstudio.com/）

• 安装 Remote - SSH 扩展（搜索并安装微软官方插件）

• 验证：左侧活动栏显示「远程资源管理器」图标表示插件安装成功。
配置 SSH 基础环境
• 本地环境：

◦ Windows 需安装 Git（自带 SSH 客户端），并将 Git 的 bin 目录（如 C:\Program Files\Git\usr\bin）添加到系统 PATH 变量。

◦ Mac/Linux 系统自带 SSH 客户端，无需额外配置。

• 远程服务器：

◦ 确保远程 Linux 服务器已安装 SSH 服务（Ubuntu 示例：sudo apt install openssh-server）。

二、远程连接配置
步骤 1：生成 SSH 密钥对（免密登录）

# 生成密钥对（Windows/Mac/Linux 通用）
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa_vscode

• 默认路径：Windows 在 C:\Users\用户名\.ssh，Mac/Linux 在 ~/.ssh。

• 公钥文件为 .pub 后缀，需复制内容到远程服务器的 ~/.ssh/authorized_keys 文件中。

步骤 2：配置 SSH 连接文件

在 VS Code 中打开远程资源管理器 → 点击齿轮图标 → 选择 SSH 配置文件（默认路径：~/.ssh/config）。

添加服务器配置模板：

Host myserver      # 自定义别名（如“腾讯云”）
  HostName 192.168.1.100  # 服务器 IP 或域名
  User root               # 登录用户名
  Port 22                 # SSH 端口（默认22）
  IdentityFile ~/.ssh/id_rsa_vscode  # 私钥路径（免密登录）

• 支持多服务器配置，通过别名区分。

步骤 3：连接远程服务器

在远程资源管理器中右键目标服务器 → 选择「Connect to Host in New Window」。
首次连接需输入密码（若未配置免密登录）并确认服务器指纹。
成功标志：VS Code 左下角显示「SSH: 服务器别名」，文件资源管理器显示远程目录。

三、远程开发功能使用

文件操作
• 直接打开远程文件/文件夹（路径为服务器端）。

• 支持本地拖拽上传文件到服务器。
插件与终端
• 插件：远程环境下需单独安装插件（如 Python、Docker），插件将运行在服务器端。

• 终端：按 Ctrl+ 打开集成终端，直接操作远程服务器命令（如编译、调试）。
调试代码
• 配置 .vscode/launch.json，指定远程程序路径和调试参数（支持 Python、C++ 等语言）。

• 示例：远程调试 Python 脚本时，断点和变量监控与本地一致。

四、高级配置技巧

跳板机（Bastion Host）

Host jumpserver
  HostName jump.example.com
  User myuser
  IdentityFile ~/.ssh/jump_key

Host targetserver
  HostName target.internal
  User admin
  ProxyCommand ssh -W %h:%p jumpserver

• 通过跳板机连接内网服务器。

保持 SSH 连接
在 ~/.ssh/config 中添加：
```
Host *
  ServerAliveInterval 60
  ServerAliveCountMax 5
```
• 防止长时间无操作导致连接断开。

五、常见问题解决

问题	解决方案
连接超时	检查防火墙是否开放 SSH 端口；确认服务器 `sshd` 服务运行状态（`systemctl status sshd`）。
权限被拒绝	检查用户名/密码是否正确；确认远程服务器 `.ssh/authorized_keys` 文件权限为 `600`。
插件安装失败	检查网络连接；手动下载扩展的 `.vsix` 文件进行离线安装。