在 VSCode 上配置 SSH 远程开发

在本地写代码、在远程 Linux 机器上跑环境，是现在很常见的开发方式。
这篇教程按“能快速用起来”的思路整理，覆盖 Windows / macOS / Linux 三个平台，默认你已经有一台可登录的 Linux 服务器（云主机 / 学校实验室机器均可）。

1. 安装 VSCode Remote SSH 插件#

在 VSCode 扩展市场安装：

• Remote - SSH（作者 Microsoft）

安装完成后，左侧活动栏会出现远程图标。

2. 生成 SSH 密钥（本地，按系统）#

Windows（PowerShell）#

先确认 OpenSSH 客户端可用：

ssh -V

如果提示找不到命令，请在「设置 -> 可选功能」安装 OpenSSH Client。然后生成密钥：

ssh-keygen -t ed25519 -C "your_email@example.com"

默认路径通常是：

• 私钥：C:\Users\你的用户名\.ssh\id_ed25519
• 公钥：C:\Users\你的用户名\.ssh\id_ed25519.pub

macOS / Linux（Terminal）#

ssh-keygen -t ed25519 -C "your_email@example.com"

默认路径：

• 私钥：~/.ssh/id_ed25519
• 公钥：~/.ssh/id_ed25519.pub

关于 passphrase 提示（你遇到的这个）#

当你看到：

Enter passphrase for "/Users/xxx/.ssh/id_ed25519" (empty for no passphrase):

这是在询问你的私钥密码（不是服务器密码）。

• 想要更安全：输入一个 passphrase（推荐）
• 想省事：直接回车留空（不推荐）

如果你已经设置了 passphrase，又不想每次都输入，可以把密钥加入 ssh-agent。

3. 把公钥上传到服务器（按系统）#

这一步会让你先输入一次服务器登录密码。输入后如果没有报错，就是成功。

ssh-copy-id -i ~/.ssh/id_ed25519.pub -p your_port username@your_server_ip

4. 配置 SSH Host（本地）#

编辑 SSH 配置文件：

• Windows：C:\Users\你的用户名\.ssh\config
• macOS / Linux：~/.ssh/config

添加：

Host my-server
  HostName your_server_ip
  User username
  Port your_port
  IdentityFile ~/.ssh/id_ed25519
  ServerAliveInterval 60
  ServerAliveCountMax 5

如果是 Windows，IdentityFile 也可以写完整路径，例如：

IdentityFile C:/Users/YourName/.ssh/id_ed25519

这样你后面直接 ssh my-server 就能连，不用每次敲完整 IP。

5. 在 VSCode 连接远程机器#

在 VSCode 中：

1. Cmd/Ctrl + Shift + P
2. 输入 Remote-SSH: Connect to Host...
3. 选择 my-server
4. 首次连接时确认 fingerprint
5. 如果弹出密码框，输入你的服务器密码

连接成功后，左下角会显示 SSH: my-server。

说明：即使你配置了密钥，首次仍可能要求你输入一次密码或 passphrase，属于正常现象。