VS Code远程开发(Remote - SSH)保姆级教程

答案：VS Code的Remote-SSH功能可直接连接远程服务器开发。安装VS Code和Remote-SSH插件后，配置SSH连接信息并保存至~/.ssh/config文件；首次连接会自动部署VS Code Server，选择平台类型并认证；成功后左下角显示绿色SSH标识，打开远程目录即可像本地一样编辑文件；推荐配置SSH密钥实现免密登录；注意检查网络、防火墙及locale设置解决常见问题。

vs code 的 remote - ssh 功能让你可以直接连接远程服务器进行开发，就像操作本地项目一样流畅。无需复制代码、不用频繁上传下载，特别适合在 linux 服务器、云主机或树莓派上写代码。下面一步步带你配置并使用它。

1. 准备工作：安装和基础环境

要使用 Remote - SSH，你需要确保以下几点已经完成：

• 安装 VS Code：前往官网（code.visualstudio.com）下载并安装最新版 VS Code。
• 安装 Remote - SSH 插件：打开 VS Code，点击左侧扩展图标（或按 Ctrl+Shift+X），搜索 “Remote - SSH”，找到由 Microsoft 发布的官方插件，点击安装。
• 本地支持 SSH：Windows 用户建议启用 OpenSSH 客户端（设置 → 应用 → 可选功能 → 添加功能 → OpenSSH 客户端）；macOS 和 Linux 一般自带 SSH，无需额外操作。
• 远程服务器开启 SSH 服务：确保目标服务器已运行 SSH 服务（通常端口 22），并且你能通过终端用 ssh 命令正常登录。

2. 配置 SSH 连接信息

VS Code 使用系统的 SSH 配置文件来管理远程主机。我们先添加一个连接配置。

1. 按下 Ctrl+Shift+P 打开命令面板。
2. 输入 “Remote-SSH: Add New SSH Host”，回车。
3. 输入连接命令，格式为：user@hostname -p port（如果用默认 22 端口可省略 -p）。例如：john@192.168.1.100 -p 2222
4. 选择保存位置，通常是 ~/.ssh/config 文件（推荐默认选项）。

之后你会在侧边栏看到这个主机名。右键可以选择“Connect to Host in New Window”开始连接。

3. 首次连接与远程环境初始化

第一次连接时，VS Code 会自动在远程服务器上部署一个轻量级的“VS Code Server”。

• 连接过程中会提示你选择 SSH 主机的平台类型（Linux / macOS / Windows），大多数服务器选 Linux。
• 输入密码或使用密钥完成身份验证。
• 等待几秒到几十秒，VS Code 会在后台传输必要文件，并启动远程服务。
• 成功后窗口左下角会显示绿色的 SSH 标识，如 “SSH: john@192.168.1.100”。

此时你已经进入远程开发模式，所有操作都在服务器上执行。

4. 打开远程项目目录

连接成功后，点击左上角“文件 → 打开文件夹”（或直接按 Ctrl+Shift+P 输入 “Open Folder”）。

怪兽智能全息舱

专业的AI数字人平台，定制数字人专属IP

16

查看详情

• 输入你要开发的路径，比如 /home/john/project。
• 确认后，VS Code 会读取该目录下的文件，就像打开本地项目一样。
• 你可以编辑、搜索、使用 Git、运行终端等，所有操作都发生在远程机器。

注意：首次可能提示安装语言服务器或 Linter，这些组件也会安装在远程端。

5. 使用密钥免密登录（推荐）

每次输入密码很麻烦，建议配置 SSH 密钥对实现无密码登录。

1. 在本地生成密钥：ssh-keygen -t rsa -b 4096，按提示保存（默认路径即可）。
2. 将公钥上传到服务器：ssh-copy-id user@host -p port。
3. 测试是否可以免密登录：ssh user@host -p port，如果不需输密码即成功。

之后通过 VS Code 连接就不会再弹出密码框了，体验更顺畅。

6. 常见问题与技巧

• 连接超时或失败：检查服务器 IP、端口、防火墙设置，确认 SSH 服务正在运行（sudo systemctl status ssh）。
• 中文乱码或终端异常：在远程服务器检查 locale 设置，确保 LANG=en_US.UTF-8 或 zh_CN.UTF-8。
• 扩展安装位置：有些扩展会装在远程端（如 Python、Docker），有些在本地（如主题、快捷键）。VS Code 会自动判断。
• 离线断开连接：关闭窗口或点击左下角 SSH 按钮选择“Close Remote Connection”即可退出。
• 多台服务器管理：可以在 ~/.ssh/config 中手动添加多个 Host 配置，结构清晰易维护。

基本上就这些。配置一次，以后点几下就能连上远程写代码，效率提升非常明显。

以上就是VS Code远程开发(Remote - SSH)保姆级教程的详细内容，更多请关注php中文网其它相关文章！