跳至主要内容

打开现有 Codespace

您可以重新打开已关闭或停止的 Codespace,并返回到您的工作。

注意

  • 目前,在 JetBrains IDE 中使用 GitHub Codespaces 处于公开测试阶段,可能会发生变化。
  • 要在 JetBrains IDE 中使用代码空间,您必须使用 JetBrains Gateway 的 2023.3.* 或 2024.1.* 版本。

您可以在 GitHub.com、JetBrains IDE、Visual Studio Code 或使用 GitHub CLI 重新打开任何处于活动状态或已停止的代码空间。您无法重新打开已删除的代码空间。有关更多信息,请参阅“了解代码空间生命周期”。

您可以在 github.com/codespaces 上的“您的代码空间”页面查看所有代码空间。在此页面上,您可以

  • 打开、停止或删除您的代码空间。
  • 查看谁拥有(以及可能为谁付费)您的代码空间:您的个人帐户或您所属的组织。有关更多信息,请参阅“关于 GitHub Codespaces 的计费”。
  • 查看您的代码空间的机器类型、大小和状态。
  • 创建一个新的代码空间,方法是选择 GitHub 的模板之一,或单击“新建代码空间”。有关更多信息,请参阅“从模板创建代码空间”和“为仓库创建代码空间”。
  • 防止自动删除代码空间。有关更多信息,请参阅“配置自动删除代码空间”。

从仓库页面恢复代码空间

当您在 GitHub.com 上查看仓库时,可以快速恢复代码空间。

  1. 使用 在 GitHub.com 上显示的代码库的 **代码** 选项卡中,按下 ,(逗号键)。

    将显示“恢复代码空间”页面。这允许您恢复最近使用的代码空间,用于当前选择的代码库分支,或者如果您正在查看拉取请求,则用于拉取请求的主题分支。

    Screenshot of the "Resume codespace" page showing the "Resume this codespace" and "Create a new one" buttons.

  2. 点击 **恢复此代码空间**。

    或者,如果您想为该代码库的此分支创建新的代码空间,请点击 **创建新的代码空间**。

    **注意**:如果您没有此分支的现有代码空间,则页面标题为“创建代码空间”,并显示一个标记为 **创建新的代码空间** 的按钮。

您可以将此页面的地址添加为书签,以便快速返回并恢复您的代码空间。或者,您可以将地址用于链接,以便为其他人提供一种快速创建和恢复他们自己代码空间的方法。

从“您的代码空间”页面打开现有代码空间

  1. 在 GitHub.com 的左上角,选择 ,然后点击 **代码空间**,这将带您到 github.com/codespaces 上的“您的代码空间”页面。

  2. 要在默认编辑器中打开代码空间,请点击代码空间的名称。您可以在个人设置页面中设置代码空间的默认编辑器。有关更多信息,请参阅“设置 GitHub 代码空间的默认编辑器”。

    要在除默认编辑器之外的编辑器中打开代码空间

    1. 点击要打开的代码空间右侧的省略号 (**...**)。
    2. 点击 **在中打开**。
    3. 点击 **在 APPLICATION 中打开**。

    Screenshot of the "Open in" dialog, with "Open in Visual Studio Code" highlighted.

    您可以在以下位置打开代码空间:

    • 您的浏览器
    • Visual Studio Code
    • JetBrains Gateway
    • JupyterLab

    如果您选择 **Visual Studio Code** 或 **JetBrains Gateway**,则必须确保已在本地计算机上安装所选应用程序。

    如果您选择 **JupyterLab**,则必须在代码空间中安装 JupyterLab 应用程序。默认的开发容器映像包含 JupyterLab,因此从默认映像创建的代码空间将始终安装 JupyterLab。有关默认映像的更多信息,请参阅“开发容器简介”和 devcontainers/images 存储库。如果您在开发容器配置中未使用默认映像,则可以通过将 ghcr.io/devcontainers/features/python 功能添加到您的 devcontainer.json 文件中来安装 JupyterLab。您应该包含选项 "installJupyterlab": true。有关更多信息,请参阅 devcontainers/features 存储库中 python 功能的 README

链接到现有代码空间

您可以创建指向现有代码空间的链接。如果您有一个长期存在的代码空间,并且经常返回到该代码空间,这将非常有用。您可以将链接保存在您选择的任何位置,作为使用 https://github.com/codespaces 上的链接的替代方法。

注意:您只能打开自己的代码空间。如果有人单击指向您代码空间之一的链接,他们将看到 404 错误消息。

使用以下 URL 模式之一创建链接。在这些 URL 中,CODESPACE-NAME 代表代码空间的唯一永久名称,例如 literate-space-parakeet-w5vg5ww5p793g7g9,而不是代码空间的显示名称。您可以通过复制 https://github.com/codespaces 页面上代码空间的链接,并从 URL 中提取代码空间名称来找到代码空间的名称。

链接在链接语法
VS Code 网页客户端https://CODESPACE-NAME.github.dev
带有指定工作区的 VS Code 网页客户端https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY
VS Code 桌面应用程序https://github.com/codespaces/CODESPACE-NAME?editor=vscode
JetBrains Gatewayhttps://github.com/codespaces/CODESPACE-NAME?editor=jetbrains
JupyterLabhttps://github.com/codespaces/CODESPACE-NAME?editor=jupyter

重新打开现有代码空间

注意:要在 VS Code 中使用 GitHub Codespaces,您需要安装 Codespaces 扩展。有关更多信息,请参阅“在 Visual Studio Code 中使用 GitHub Codespaces”。

  1. 在 VS Code 桌面应用程序中,使用 Command+Shift+P(Mac)或 Ctrl+Shift+P(Windows/Linux)打开命令面板。

  2. 输入 "Codespaces" 并选择以下命令之一。

    • 要在 VS Code 的新窗口中打开 codespace,请选择 **Codespaces: 在新窗口中打开 Codespace**
    • 要在 Web 编辑器中打开 codespace,请选择 **Codespaces: 在浏览器中打开**
  3. 单击要打开的 codespace。

    Screenshot of the VS Code Command Palette showing a list of codespaces available to connect to.

您也可以通过导航到 VS Code 中的远程资源管理器视图并右键单击要打开的 codespace 来访问上面列出的命令。

Screenshot of a codespace selected in the Remote Explorer, with "Open in Browser" highlighted in the right-click menu.

注意:如果活动栏中未显示远程资源管理器

  1. 访问命令面板。例如,通过按 Shift+Command+P(Mac)/ Ctrl+Shift+P(Windows/Linux)。
  2. 输入:details
  3. 单击 **Codespaces: 详细信息**。

链接到现有代码空间

您可以创建指向现有代码空间的链接。如果您有一个长期存在的代码空间,并且经常返回到该代码空间,这将非常有用。您可以将链接保存在您选择的任何位置,作为使用 https://github.com/codespaces 上的链接的替代方法。

注意:您只能打开自己的代码空间。如果有人单击指向您代码空间之一的链接,他们将看到 404 错误消息。

使用以下 URL 模式之一创建链接。在这些 URL 中,CODESPACE-NAME 代表代码空间的唯一永久名称,例如 literate-space-parakeet-w5vg5ww5p793g7g9,而不是代码空间的显示名称。您可以通过复制 https://github.com/codespaces 页面上代码空间的链接,并从 URL 中提取代码空间名称来找到代码空间的名称。

链接在链接语法
VS Code 网页客户端https://CODESPACE-NAME.github.dev
带有指定工作区的 VS Code 网页客户端https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY
VS Code 桌面应用程序https://github.com/codespaces/CODESPACE-NAME?editor=vscode
JetBrains Gatewayhttps://github.com/codespaces/CODESPACE-NAME?editor=jetbrains
JupyterLabhttps://github.com/codespaces/CODESPACE-NAME?editor=jupyter

重新打开现有代码空间

如果您已安装 GitHub CLI,则可以使用它来使用 GitHub Codespaces。有关 GitHub CLI 的安装说明,请参阅 GitHub CLI 存储库

  1. 在终端中,输入以下 GitHub CLI 命令之一。

    • 要在 VS Code 中打开 codespace,请输入

      Shell
      gh codespace code
      

      注意:您必须在本地计算机上安装 VS Code。有关更多信息,请参阅 VS Code 文档中的 "设置 Visual Studio Code"。

    • 要在浏览器中打开 codespace,请输入

      Shell
      gh codespace code --web
      
    • 要在 JupyterLab 中打开 codespace,请输入

      Shell
      gh codespace jupyter
      

      注意:您要打开的 codespace 中必须安装 JupyterLab 应用程序。默认的开发容器映像包含 JupyterLab,因此从默认映像创建的 codespace 将始终安装 JupyterLab。有关默认映像的更多信息,请参阅 "开发容器简介" 和 devcontainers/images 存储库。如果您在开发容器配置中未使用默认映像,则可以通过将 ghcr.io/devcontainers/features/python 功能添加到 devcontainer.json 文件来安装 JupyterLab。您应该包含选项 "installJupyterlab": true。有关更多信息,请参阅 devcontainers/features 存储库中的 python 功能的 README

    • 要从命令行通过 SSH 访问 codespace,请输入

      Shell
      gh codespace ssh
      
  2. 使用箭头键导航到要打开的 codespace。

  3. 要打开代码空间,请按 Enter 键。

有关更多信息,请参阅 GitHub CLI 手册中的 gh codespace code

重新打开现有代码空间

如果您已将 JetBrains Gateway 设置为默认编辑器,则当您从 GitHub.com 打开代码空间时,Gateway 将自动启动。

如果 JetBrains Gateway 不是您的默认编辑器,您仍然可以通过访问 github.com/codespaces 上的“您的代码空间”页面,然后单击要打开的代码空间右侧的省略号 (...) 在 JetBrains 中打开代码空间。有关更多信息,请参阅“打开现有代码空间”。

或者,您也可以打开 JetBrains Gateway 并选择一个现有代码空间,如以下步骤所述。

  1. 打开 JetBrains Gateway 应用程序。

  2. 单击 **连接到代码空间**。

    Screenshot of the JetBrains Gateway home page, showing the "Connect to Codespaces" button.

  3. 在“您的代码空间”列表中,单击您要使用的代码空间。

    Screenshot of the "Your Codespaces" list in the JetBrains Gateway.

  4. 在“可用 IDE”列表中,单击您要使用的 JetBrains IDE。Gateway 会记住您下次连接到代码空间时的选择。

    Screenshot the "Select IDE" dropdown list in the JetBrains Gateway. The mouse pointer is pointing to "IntelliJ IDEA."

  5. 单击 **连接**。

    注意:

    • 如果您选择 Rider 作为您的 JetBrains IDE,并且存储库包含多个解决方案文件,则会显示“设置解决方案路径”对话框,提示您选择要使用的解决方案。从下拉菜单中选择一个解决方案文件,然后单击 **确定**。

      如果存储库没有解决方案文件,Rider 将在基本项目目录视图中打开,并且功能有限。例如,您将无法获得特定于 .NET 的代码导航。如果存储库中只有一个解决方案文件,它将被自动使用,而不会显示提示。有关更多信息,请参阅 JetBrains 文档中的“创建和打开项目和解决方案”。

    • 如果您正在运行防火墙,则第一次连接到远程资源时,系统可能会提示您允许 JetBrains Gateway 通过您的网络进行通信。

进一步阅读