远程开发概述

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

通过远程开发，您可以：

连接

远程主机是承载源代码并运行后端 IDE 的物理或虚拟机。您将连接到后端，该后端透明地提供对所有 IDE 功能的完整访问。

可以通过多种方案与远程计算机建立连接：

从本地计算机到远程服务器的 SSH 连接，或反之（从服务器上已安装的 IDE 到本地计算机）。

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

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

在远程计算机上为远程文件系统中包含 JSON 文件的项目或为从 Git 存储库克隆的项目启动 Dev Container 时的 Development Container 连接。

有关此工作流的说明，请参阅为远程项目启动开发容器。

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

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

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

可以通过以下方式使用各种 PyCharm 插件扩展后端：

将所需插件解压到相应目录中
运行以下代码（需要网络连接到 JetBrains Marketplace）：
remote-dev-server installPlugins <PLUGIN_ID1> <PLUGIN_ID2> ...
请查看以下示例：
remote-dev-server installPlugins IdeaVIM

如果某个插件提供了一组新的检查和功能，这些内容都会在 JetBrains Client 中显示。

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

与其他任何基于 IntelliJ 平台的产品一样，JetBrains Gateway 也可以扩展。

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

使用 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/zh-cn/intellij-repository/snapshots 查看可用版本（参见组 com.jetbrains.gateway）。

除基本的 SSH 和 Code With Me 连接外，供应商可以为其自己的编排服务定制 JetBrains Gateway。这可以通过 JetBrains 与供应商之间的定制协议来实现。

JetBrains Gateway 基于 IntelliJ 平台，并提供用于与 JetBrains Client 进行连接和交互的 API。

请查看以下示例：

某大型组织希望编写其自己的编排。出于安全原因，基本的 SSH 流程无法满足要求。该组织编写了一个内部插件，并将其分发给其开发人员。开发人员可以在 JetBrains Gateway 或其笔记本电脑上的 PyCharm 中安装该插件。

这是一份对 API 的非常简要介绍（API 尚未最终确定，而且这确实不是完整范围，但足以说明总体思路）。

JetBrains Client 并未针对连接部分设计可扩展性。不过，您可以开发并安装各类 PyCharm 插件，这些插件可修改 UI、键盘快捷键、主题，以及涉及 IDE UI 交互的其他部分，但不会改变其功能。

最后修改日期： 2025年 12月 2日