VS Code 连接 Linux 服务器教程

本文介绍如何使用 Visual Studio Code 通过 Remote‑SSH 插件连接到远程 Linux 服务器，实现代码编辑、调试和文件管理。

前置条件

• 本地已安装 Visual Studio Code（最新版）。
• 目标服务器已启用 SSH 服务（默认端口 22），并拥有可登录的账户。
• 本地机器上已生成 SSH 密钥对（ssh-keygen），或者已知服务器登录密码。

1. 安装 Remote‑SSH 扩展

在 VS Code 左侧扩展市场搜索 Remote - SSH，点击 Install，安装完成后会在左下角出现绿色 >< 图标。

2. 配置 SSH 连接

打开命令面板 (Ctrl+Shift+P)，输入 Remote-SSH: Open Config File，选择默认的 ~/.ssh/config（如果文件不存在会自动创建）。在文件中添加一个主机条目：

Host my-linux
    HostName your.server.com       # 服务器 IP 或域名
    User youruser                  # 登录用户名
    Port 22                        # 若非默认端口请修改
    IdentityFile ~/.ssh/id_rsa     # 使用的私钥路径（可选）

保存文件后，在命令面板再次执行 Remote-SSH: Connect to Host...，选择刚才添加的 my-linux。

3. 使用密码或密钥登录

• 密钥登录：如果你已经把本地公钥 (~/.ssh/id_rsa.pub) 添加到服务器的 ~/.ssh/authorized_keys，VS Code 会直接免密登录。
• 密码登录：如果没有密钥，系统会弹出密码输入框，输入服务器密码即可。

4. 连接成功后会出现新窗口

左下角会显示 SSH: my-linux，此时所有打开的文件、终端和调试均在远程机器上运行。你可以直接打开 /var/www/html、编辑配置文件或运行 git。

5. 常用操作

• 打开终端：Ctrl+`，默认是远程机器的 Shell。
• 安装扩展到远程主机：在左侧扩展栏点击 … -> Install on SSH Host。
• 调试 Node/Python：在 launch.json 中选择 Remote Attach 或者直接使用 Debug on Remote Host。

6. 常见问题 & 排查

1. 无法连接，提示 "Connection timed out"：检查服务器防火墙是否放通 22 端口，或确认 HostName 正确。
2. 密钥权限错误：确保 ~/.ssh 目录权限 700，私钥文件权限 600。
3. 出现 "Host verification failed"：首次连接时会提示确认指纹，接受后会在 ~/.ssh/known_hosts 中记录。
4. SSH 代理转发：若需要在远程机器上使用本地 SSH 代理，可在 config 中加入 ForwardAgent yes。

7. 完整示例

# 本地生成密钥（如果还没有）
ssh-keygen -t rsa -b 4096 -C "your@email"
# 将公钥复制到服务器
ssh-copy-id -i ~/.ssh/id_rsa.pub youruser@your.server.com

# ~/.ssh/config 内容示例
Host my-linux
    HostName your.server.com
    User youruser
    Port 22
    IdentityFile ~/.ssh/id_rsa
    ForwardAgent yes

完成以上配置后，在 VS Code 中 Remote-SSH: Connect to Host → my-linux 即可开始远程开发。

结语

使用 VS Code 的 Remote‑SSH 插件，你可以像本地编辑一样在远程 Linux 服务器上进行开发、调试，省去传统的 SSH + vim 工作流，提升生产力。