远程开发概述

远程开发允许您使用远程计算机、开发容器、WSL 或各类提供方来检出和加载项目、建立索引、分析、构建、运行、调试以及测试代码。

使用远程开发，您可以执行以下操作：

连接

远程主机是一台托管源代码并运行前端 IDE 的物理或虚拟机。您将连接到后端，其可透明地提供对所有 IDE 功能的完全访问权限。

可以使用多种场景与远程计算机建立连接：

从本地计算机通过 SSH 连接到远程服务器，或反向操作（从服务器中已安装的 IDE 连接到本地计算机）。

您可以使用以下任一方法：

JetBrains Toolbox 应用：在 Linux、macOS 和 Windows 上支持连接。有关详细信息，请参阅 Toolbox App 页面。
WebStorm ：可通过 WebStorm 欢迎界面连接到远程项目。有关详细信息，请参阅从 WebStorm 连接到远程服务器。
JetBrains Gateway ：可使用 JetBrains Gateway 通过 SSH 连接到 Linux 计算机。您还可以连接到各种开发环境。
有关详细信息，请参阅连接并使用 JetBrains Gateway。

启动 Dev Container 时，Dev Container 连接适用于远程文件系统中包含 JSON 文件的项目，或从 Git 仓库克隆的项目。

有关此工作流的说明，请参阅为远程项目启动 Dev Container。

将 IDE 后端配置为直接在 WSL2 中启动时的 WSL 连接。 JetBrains Gateway 为此场景提供原生 WSL 支持。

如需了解详细信息，请参阅连接到在 WSL2 上运行的项目。

通过 JetBrains Gateway 也可连接到运行在 JetBrains CodeCanvas、Gitpod、Google Cloud、GitHub Codespaces、Amazon CodeCatalyst 和 Coder 上的各类开发环境。

有关如何连接到每个环境的详细信息，请参阅连接并使用 JetBrains Gateway。

可通过以下方式，将后端扩展为支持丰富的 WebStorm 插件：

将所需插件解压至合适的目录
运行以下代码（需连接至 JetBrains Marketplace）：
remote-dev-server installPlugins <PLUGIN_ID1> <PLUGIN_ID2> ...
请查看以下示例：
remote-dev-server installPlugins IdeaVIM

如果插件提供了一组新的代码检查或功能，这些内容都会显示在 JetBrains Client 上。

有关详细信息，请参阅安装插件。

JetBrains Gateway 可如其他基于 IntelliJ 平台的产品一样进行扩展。

您可以使用以下方法之一：

使用 https://github.com/JetBrains/gradle-intellij-plugin/ 创建新项目（gradle-intellij-plugin 应为 ≥ 1.1.4）
使用以下设置，构建与 JetBrains Gateway 配套的插件：
intellij { version.set("213.2667-CUSTOM-SNAPSHOT") type.set("GW") instrumentCode.set(false) }
您可以在 https://www.jetbrains.com.cn/intellij-repository/snapshots （参见 group com.jetbrains.gateway）查看可用版本

除基本 SSH 和 Code With Me 连接外，供应商还可以为其自身的编排服务定制 JetBrains Gateway。这可在 JetBrains 与供应商之间的定制协议中完成。

JetBrains Gateway 基于 IntelliJ 平台构建，具备与 JetBrains Client 建立连接与交互的 API。

请查看以下示例：

某大型组织希望编写自己的编排工具。由于安全因素，基本 SSH 流程无法满足要求。该组织开发了一个内部插件，并将其分发给开发人员。开发人员可在 JetBrains Gateway 或笔记本计算机中的 WebStorm 中安装此插件。

以下是对这些 API 的简要介绍（目前仍非最终版本，范围也未全面覆盖，但足以帮助理解整体思路）。

JetBrains Client 在连接部分的设计上并不支持扩展。不过，您可以开发并安装各种 WebStorm 插件，用于修改 UI、快捷键、主题等 IDE UI 交互部分（但不影响其功能）。

最后修改日期： 2025年 9月 26日