Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

在 JetBrains IDE 中使用 GitHub Codespaces

可以使用 JetBrains 网关连接到 codespace,并在你喜欢的 JetBrains IDE 中工作。

注意:在 JetBrains IDE 中使用 GitHub Codespaces 目前为公开 beta 版本,可能会随时发生更改。

关于 JetBrains IDE 中的 Codespaces

如果使用 JetBrains IDE 来处理代码,则可以利用在 codespace 中工作的优势。 可以使用 JetBrains 网关应用程序执行此操作。

安装 JetBrains 网关后,可以将 JetBrains 设置为默认编辑器,然后每当从 GitHub.com 打开 codespace 时,JetBrains 网关将启动,以允许你选择 JetBrains IDE 并连接到 codespace。

注意:JetBrains 网关中只有现有的 codespace 可用。 可以在 GitHub.com 中或使用 GitHub CLI 创建 codespace。 有关详细信息,请参阅“为存储库创建 codespace”。

JetBrains 远程开发连接过程

在 JetBrains IDE 中使用 codespace 的基本过程如下所示。

  • 在 JetBrains 网关应用程序中,选择一个活动或已停止的 codespace。
  • 然后选择要使用的 JetBrains IDE。
  • 然后将所选 JetBrains IDE 下载到托管 codespace 和源代码的远程虚拟机。
  • 然后将 JetBrains 瘦客户端应用程序下载到本地计算机并启动。
  • 客户端应用程序连接到完整的后端 IDE。
  • 可以在客户端应用程序中以与在本地环境中相同的方式处理代码。

先决条件

若要在 JetBrains IDE 中的 codespace 中工作,需要:

  • 有效的 JetBrains 许可证
  • JetBrains 网关应用程序
  • GitHub CLI 版本 2.18.0 或更高版本
  • 运行 SSH 服务器的现有 codespace

JetBrains 许可证

必须拥有至少一个受支持的 JetBrains IDE 的许可证,才能从 JetBrains 网关连接到 codespace。

JetBrains 网关

可以从 JetBrains 工具箱应用程序安装和更新 JetBrains 网关。

  1. 下载并安装 JetBrains 工具箱

  2. 打开 JetBrains 工具箱。

  3. 在可用工具列表中找到“网关”,然后单击“安装” 。

    JetBrains 工具箱的屏幕截图

GitHub CLI

JetBrains 网关的 GitHub Codespaces 插件要求先安装并配置 GitHub CLI 版本 2.18.0 或更高版本,然后才能从 JetBrains 网关打开 codespace。

使用此命令检查 GitHub CLI 的版本:

Shell
gh --version

有关详细信息,请参阅“关于 GitHub CLI”。

运行 SSH 服务器的 codespace

必须具有要连接到的现有 codespace。 可以在 GitHub.com 上、Visual Studio Code 中或使用 GitHub CLI 创建代码空间。 有关详细信息,请参阅“为存储库创建 codespace”。

连接到的 codespace 必须运行 SSH 服务器。 默认容器映像包含一个可自动启动的 SSH 服务器。 如果未通过默认映像创建 codespace,可以通过将以下内容添加到 devcontainer.json 文件中的 features 对象来安装和启动 SSH 服务器。

"features": {
    ...
    "ghcr.io/devcontainers/features/sshd:1": {
        "version": "latest"
    },
    ...
}

有关 devcontainer.json 文件和默认容器映像的详细信息,请参阅“开发容器简介”。

注意:有关通过 SSH 连接到 codespace 的帮助,请参阅“GitHub Codespaces 客户端故障排除”。

设置 JetBrains 网关

首次对 GitHub Codespaces 使用 JetBrains 网关时,必须安装 Codespaces 插件。 还必须允许 JetBrains 网关使用 GitHub 帐户访问 GitHub.com。

  1. 打开 JetBrains 网关应用程序。

  2. 在“安装更多提供程序”下,单击 GitHub Codespaces 的“安装”链接 。

    JetBrains 网关初始视图的屏幕截图

  3. 单击“连接到 Codespace”。

    带有“连接到 Codespace”按钮的网关屏幕截图

  4. 在“欢迎使用 JetBrains 网关”对话框中,单击“使用 GitHub 登录”。

    “登录”按钮的屏幕截图

  5. 单击一次性代码旁边的图标进行复制,然后单击登录链接。

    一次性登录代码的屏幕截图

  6. 如果当前未登录到 GitHub,则会显示登录页面。

    • 输入详细信息,然后单击“登录”。
    • 进行身份验证,例如输入双因素身份验证代码。
  7. 在“设备激活”页上,粘贴复制的代码,然后单击“继续”。

  8. 如果你属于组织,则会显示“单一登录到组织”页。 单击要授权 JetBrains 网关访问的组织旁边的“授权”,然后单击“继续” 。

  9. 在“为 JetBrains 授权 GitHub Codespaces”页上,单击“授权 GitHub”。

  10. 返回到 JetBrains 网关应用程序,并从当前活动或已停止的 codespace 列表中打开一个 codespace,请参阅以下过程的步骤 3。

在 JetBrains IDE 中打开一个 codespace

如果已将 JetBrains 网关设置为默认编辑器,则在从 GitHub.com 打开 codespace 时,网关将自动启动。

如果 JetBrains 网关不是默认编辑器,你仍然可以在 JetBrains 中打开 codespace,方法是转到 github.com/codespaces 的“你的 codespace”页,然后单击要打开的 codespace 右侧的省略号 (...)。 有关详细信息,请参阅“打开现有 codespace”。

或者,也可以打开 JetBrains 网关并选择现有 codespace,如以下过程所述。

  1. 打开 JetBrains 网关应用程序。

  2. 单击“连接到 Codespaces”。

    JetBrains 网关初始视图的屏幕截图

  3. 在“你的 Codespace”列表中,单击要处理的 codespace。

    JetBrains 网关 codespace 列表的屏幕截图

  4. 在“可用 IDE”列表中,单击要使用的 JetBrains IDE。 下次连接到 codespace 时,网关将记住你的选择。

    JetBrains 网关 codespace 列表的屏幕截图

  5. 单击“连接” 。

    注意:如果运行的是防火墙:首次连接到远程资源时,系统可能会提示允许 JetBrains 网关跨网络通信。

    首次连接到 codespace 时,后端 IDE 将下载到远程计算机。 这可能需要几分钟的时间。 下次连接到同一 codespace 时不需要执行此步骤,从而加快连接过程。

    然后启动后端 IDE。 同样,如果将来要重新连接到保持运行的后端 IDE,则不需要执行此步骤。

    然后启动客户端应用程序。

延伸阅读