VSCode远程开发环境搭建_VSCode连接服务器运行代码教程

蓮花仙者

发布时间：2025-08-25 14:26:01

658人浏览过

来源于php中文网

原创

搭建VSCode远程开发环境可通过Remote-SSH扩展连接远程服务器，在服务器上运行和调试代码，适用于高性能计算或团队协作场景。首先确保服务器支持SSH并安装所需开发环境，然后在VSCode中安装“Remote - SSH”扩展，配置SSH主机信息并连接，打开远程文件夹即可编辑代码。运行代码时，VSCode会在远程终端执行，结果实时返回。若遇连接失败提示“目标机器主动拒绝”，需检查SSH服务状态（sudo systemctl status ssh）并启动服务，确认防火墙允许SSH端口（默认22），可使用ufw allow ssh放行。此外，VSCode还支持Remote-Containers（Docker容器开发）、Remote-WSL（Windows上Linux环境开发）和Remote-Tunnels（免SSH隧道连接）等模式，适配不同需求。调试功能需在服务器安装对应调试器（如Python的debugpy），并在VSCode中配置launch.json文件设置断点进行单步调试。为提升体验，建议使用SSH密钥免密登录，配置.ssh/config简化连接，安装常用插件增强功能，并结合tmux/screen保持会话持久，合理利用缓存提高加载速度。

vscode远程开发环境搭建_vscode连接服务器运行代码教程

简单来说，搭建VSCode远程开发环境，就是让你的本地VSCode连接到远程服务器，然后在服务器上运行代码。这对于需要在高性能服务器上运行大型项目，或者需要在统一的环境下进行团队协作开发的情况非常有用。

连接服务器运行代码教程：

服务器准备： 确保你有一台可以SSH连接的服务器，并且安装了必要的开发环境（比如Python、Java、Node.js等）。建议使用Linux系统，因为VSCode对Linux的支持最好。
安装Remote Development扩展： 在VSCode中，安装 "Remote - SSH" 扩展。这是微软官方的远程开发扩展，非常稳定和易用。
配置SSH连接： 点击VSCode左侧的Remote Explorer图标（或者按
```
Ctrl+Shift+P
```
，输入"Remote-SSH: Connect to Host..."），选择 "Add New SSH Host..."，然后输入你的服务器SSH连接信息（例如：
```
user@your_server_ip
```
）。
连接服务器： 在Remote Explorer中，找到你刚刚添加的服务器，点击右侧的连接图标。VSCode会提示你输入SSH密码（或者使用SSH密钥进行认证）。
打开远程文件夹： 连接成功后，点击 "Open Folder" 按钮，选择服务器上的代码目录。VSCode会自动加载远程文件，并且可以在本地进行编辑。
运行代码： 在VSCode中打开你的代码文件，按下
```
Ctrl+Shift+P
```
，输入 "Run Python File in Terminal" (以Python为例)，就可以在服务器上运行代码了。VSCode会在底部的Terminal面板中显示运行结果。

为什么需要VSCode远程开发？本地开发不香吗？

本地开发当然有它的优势，比如响应速度快，网络依赖小。但是，当你的项目变得越来越大，或者需要使用特定的硬件资源（比如GPU），或者需要与团队成员共享开发环境时，本地开发就会遇到瓶颈。

举个例子，我之前参与一个深度学习项目，模型训练需要大量的GPU资源。如果我在本地电脑上训练，速度慢不说，还会占用大量的本地资源，影响日常使用。使用VSCode远程连接到GPU服务器，就可以充分利用服务器的计算能力，并且可以随时随地进行开发，非常方便。而且，通过统一的开发环境，可以避免因为环境差异导致的代码问题，提高团队协作效率。

VSCode Remote - SSH连接失败，提示"Could not establish connection to "xxx": The target machine actively refused it."怎么办？

这个问题通常是由于服务器的SSH服务没有启动，或者防火墙阻止了SSH连接。

首先，检查服务器的SSH服务是否正在运行。可以使用以下命令：

sudo systemctl status ssh

如果SSH服务没有运行，可以使用以下命令启动：

sudo systemctl start ssh

如果SSH服务正在运行，但是仍然无法连接，可能是防火墙阻止了SSH连接。可以使用以下命令检查防火墙规则：

sudo ufw status

如果防火墙阻止了SSH连接，可以使用以下命令允许SSH连接：

sudo ufw allow ssh

另外，还要确保你的本地电脑可以访问服务器的22端口（或者你配置的SSH端口）。可以使用

telnet your_server_ip 22

命令进行测试。如果无法连接，可能是本地防火墙或者网络问题。

除了Remote - SSH，还有其他的VSCode远程开发方式吗？

当然有。除了Remote - SSH，VSCode还支持以下几种远程开发方式：

Whimsical

Whimsical推出的AI思维导图工具

下载

Remote - Containers： 使用Docker容器作为开发环境。这种方式可以确保开发环境的一致性，并且可以方便地进行环境配置和管理。
Remote - WSL： 在Windows Subsystem for Linux (WSL) 中进行开发。这种方式可以在Windows系统上使用Linux环境，非常适合需要在Linux环境下进行开发的开发者。
Remote - Tunnels： 使用VS Code Tunnel服务，无需配置SSH，即可安全地连接到远程机器。这种方式简化了配置过程，特别适合临时访问或快速搭建开发环境。

选择哪种方式取决于你的具体需求和偏好。Remote - SSH是最常用和稳定的方式，Remote - Containers适合需要高度一致性的开发环境，Remote - WSL适合在Windows系统上进行Linux开发的开发者，Remote - Tunnels则适合快速搭建环境。