# 打开现有 codespace

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

你可以在 GitHub、Visual Studio Code 中或通过 GitHub CLI 重新打开任何活跃或已停止的代码空间。 无法重新打开已删除的 codespace。 请参阅“[了解代码空间的生命周期](/zh/codespaces/about-codespaces/understanding-the-codespace-lifecycle)”。

可以在“你的 codespace”页 ([github.com/codespaces](https://github.com/codespaces)) 上查看所有 codespace。 在此页中，可以：

* 打开、停止或删除 codespace。
* 了解谁拥有 codespace（并可能为 codespace 付费）：你的个人帐户或你所属的组织。 请参阅“[GitHub Codespaces 计费](/zh/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)”。
* 查看 codespace 的计算机类型、大小和状态。
* 创建新的代码空间，可选择 GitHub 的模板之一，或单击“新建代码空间”\*\*\*\*。 请参阅“[通过模板创建 codespace](/zh/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template)”和“[为代码库创建代码空间](/zh/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository)”。
* 阻止自动删除 codespace。 请参阅“[配置 codespace 的自动删除](/zh/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces?tool=webui#avoiding-automatic-deletion-of-codespaces)”。

<div class="ghd-tool webui">

## 从存储库页恢复 codespace

在 GitHub 上查看存储库时，可以快速恢复 codespace。

1. 在 GitHub 上显示存储库的“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code" aria-label="code" role="img"><path d="m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z"></path></svg> Code”选项卡后，按“**,**”（逗号键）<kbd></kbd>。

   随即将显示“恢复 codespace”页。 这样可以恢复存储库当前所选分支的最近使用的 codespace，如果正在查看拉取请求，则恢复该拉取请求的主题分支的最近使用的 codespace。

   ![“恢复 codespace”页的屏幕截图，其中显示了“恢复此 codespace”和“新建 codespace”按钮。](/assets/images/help/codespaces/resume-codespace.png)

2. 单击“恢复此代码空间”\*\*\*\*。

   或者，如果你想为此存储库的此分支创建新的代码空间，请单击“创建一个新的”\*\*\*\*。

   > \[!NOTE]
   > 如果此分支没有现有的代码空间，页面标题将为“创建代码空间”，并显示标有“创建新的代码空间”\*\*\*\* 的按钮。

如果要快速返回到此页面地址以恢复 codespace，则可将此页面地址加入书签。 或者你也可在链接中使用这个地址，为其他人提供一种快速方法来为此存储库创建和恢复自己的 codespace。

## 从“你的 codespaces”页打开现有 codespace

1. 在 GitHub 的左上角，选择 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-three-bars" aria-label="Open global navigation menu" role="img"><path d="M1 2.75A.75.75 0 0 1 1.75 2h12.5a.75.75 0 0 1 0 1.5H1.75A.75.75 0 0 1 1 2.75Zm0 5A.75.75 0 0 1 1.75 7h12.5a.75.75 0 0 1 0 1.5H1.75A.75.75 0 0 1 1 7.75ZM1.75 12h12.5a.75.75 0 0 1 0 1.5H1.75a.75.75 0 0 1 0-1.5Z"></path></svg>，然后单击“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-codespaces" aria-label="codespaces" role="img"><path d="M0 11.25c0-.966.784-1.75 1.75-1.75h12.5c.966 0 1.75.784 1.75 1.75v3A1.75 1.75 0 0 1 14.25 16H1.75A1.75 1.75 0 0 1 0 14.25Zm2-9.5C2 .784 2.784 0 3.75 0h8.5C13.216 0 14 .784 14 1.75v5a1.75 1.75 0 0 1-1.75 1.75h-8.5A1.75 1.75 0 0 1 2 6.75Zm1.75-.25a.25.25 0 0 0-.25.25v5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-5a.25.25 0 0 0-.25-.25Zm-2 9.5a.25.25 0 0 0-.25.25v3c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-3a.25.25 0 0 0-.25-.25Z"></path><path d="M7 12.75a.75.75 0 0 1 .75-.75h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1-.75-.75Zm-4 0a.75.75 0 0 1 .75-.75h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1-.75-.75Z"></path></svg> Codespaces”，转到 [github.com/codespaces](https://github.com/codespaces) 上的“Your codespaces”页面\*\*\*\*。
2. 要在默认编辑器中打开 codespace，请单击 codespace 的名称。 您可以在个人设置页面中设置 Codespaces 的默认编辑器。 请参阅 [为 GitHub Codespaces 设置默认编辑器](/zh/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces)。

   如需从非默认编辑器中打开 codespace，请执行以下操作：

   1. 单击要打开的代码空间（codespace）右侧的省略号 (**...**)。
   2. 单击“打开方式”\*\*\*\*。
   3. 单击“在应用程序中打开”\*\*\*\*。

   可以在以下项中打开 codespace：

   * 浏览器
   * Visual Studio Code
   * JupyterLab

   如果选择 **Visual Studio Code**（桌面应用程序），则必须确保已在本地计算机上安装VS Code。

   如果选择 **JupyterLab**，则必须在代码空间中安装 JupyterLab 应用程序。 默认开发容器映像包括 JupyterLab，因此从默认映像创建的 codespaces 将始终安装 JupyterLab。 有关默认映像的详细信息，请参阅“[开发容器简介](/zh/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#using-the-default-dev-container-configuration)”以及 [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src/universal) 仓库。 如果未在开发容器配置中使用默认映像，则可以通过将 `ghcr.io/devcontainers/features/python` 功能添加到 `devcontainer.json` 文件来安装 JupyterLab。 应该包括选项 `"installJupyterlab": true`。 有关详细信息，请参阅 `devcontainers/features` 存储库中 [`python`](https://github.com/devcontainers/features/tree/main/src/python#python-python) 功能的 README 文件。

## 链接到现有 codespace

可以创建指向现有 codespace 的链接。 如果你有一个经常返回的长期 codespace，这将非常有用。 可以将链接保存在你选择的位置中，作为使用 <https://github.com/codespaces> 上的链接的替代项。

> \[!NOTE]
> 你只能打开自己的 codespace。 如果有人单击指向你的其中一个 codespace 的链接，他们将看到 404 错误消息。

使用以下其中一种 URL 模式创建链接。 在这些 URL 中，`CODESPACE-NAME` 表示 Codespace 的唯一永久名称，例如 `literate-space-parakeet-w5vg5ww5p793g7g9`，而不是 Codespace 的显示名称。 你可以通过将链接复制到 <https://github.com/codespaces> 页面上的 codespace 并从 URL 中提取 codespace 名称来查找 codespace 的名称。

| **链接将打开于**               | **链接语法**                                                                           |
| ------------------------ | ---------------------------------------------------------------------------------- |
| VS Code Web 客户端          | `https://CODESPACE-NAME.github.dev`                                                |
| 具有指定工作区的 VS Code Web 客户端 | `https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY` |
| VS Code 桌面应用程序           | `https://github.com/codespaces/CODESPACE-NAME?editor=vscode`                       |
| JupyterLab               | `https://github.com/codespaces/CODESPACE-NAME?editor=jupyter`                      |

</div>

<div class="ghd-tool vscode">

## 重新打开现有 codespace

> \[!NOTE]
> 要在 GitHub Codespaces 中使用 VS Code，你需要安装 Codespaces 扩展。 请参阅 [在 Visual Studio Code 中使用 GitHub Codespaces](/zh/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code)。

1. 在 VS Code 桌面应用程序中，使用 <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Mac) 或 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux) 打开命令面板。
2. 键入“Codespaces”并选择以下命令之一。
   * 要在 VS Code 的新窗口中打开代码空间，请选择“代码空间：在新窗口中打开代码空间”\*\*\*\*
   * 要在 Web 编辑器中打开代码空间，请选择“代码空间：在浏览器中打开”\*\*\*\*
3. 单击要打开的 codespace。

   ![VS Code 命令面板的屏幕截图，其中显示了可用于连接的代码空间列表。](/assets/images/help/codespaces/open-codespace-from-vscode.png)

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

![在“远程资源管理器”中选择的 codespace 的屏幕截图，右键单击菜单中突出显示了“在浏览器中打开”。](/assets/images/help/codespaces/open-codespace-remote-explorer.png)

> \[!NOTE]
> 如果远程资源管理器未显示在活动栏中：
>
> 1. 访问命令面板。 例如，通过按 <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)。
> 2. 键入：`details`。
> 3. 单击“Codespace: 详细信息”。

## 链接到现有 codespace

可以创建指向现有 codespace 的链接。 如果你有一个经常返回的长期 codespace，这将非常有用。 可以将链接保存在你选择的位置中，作为使用 <https://github.com/codespaces> 上的链接的替代项。

> \[!NOTE]
> 你只能打开自己的 codespace。 如果有人单击指向你的其中一个 codespace 的链接，他们将看到 404 错误消息。

使用以下其中一种 URL 模式创建链接。 在这些 URL 中，`CODESPACE-NAME` 表示 Codespace 的唯一永久名称，例如 `literate-space-parakeet-w5vg5ww5p793g7g9`，而不是 Codespace 的显示名称。 你可以通过将链接复制到 <https://github.com/codespaces> 页面上的 codespace 并从 URL 中提取 codespace 名称来查找 codespace 的名称。

| **链接将打开于**               | **链接语法**                                                                           |
| ------------------------ | ---------------------------------------------------------------------------------- |
| VS Code Web 客户端          | `https://CODESPACE-NAME.github.dev`                                                |
| 具有指定工作区的 VS Code Web 客户端 | `https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY` |
| VS Code 桌面应用程序           | `https://github.com/codespaces/CODESPACE-NAME?editor=vscode`                       |
| JupyterLab               | `https://github.com/codespaces/CODESPACE-NAME?editor=jupyter`                      |

</div>

<div class="ghd-tool cli">

## 重新打开现有 codespace

如果已安装 GitHub CLI，则可以使用它来处理 GitHub Codespaces。 有关 GitHub CLI 的安装说明，请参阅 [GitHub CLI 存储库](https://github.com/cli/cli#installation)。

1. 在终端中，输入以下 GitHub CLI 命令之一。
   * 要在 VS Code 中删除 codespace，请输入：

     ```shell copy
     gh codespace code
     ```

     > \[!NOTE]
     > 必须在本地计算机上安装 VS Code。 请参阅 Visual Studio Code 文档中的[设置 VS Code](https://code.visualstudio.com/docs/setup/setup-overview)。

   * 要在浏览器中打开 codespace，请输入：

     ```shell copy
     gh codespace code --web
     ```

   * 要在 JupyterLab 中打开 codespace，请输入：

     ```shell copy
     gh codespace jupyter
     ```

     > \[!NOTE]
     > JupyterLab 应用程序必须安装在要打开的 Codespace 中。 默认开发容器映像包括 JupyterLab，因此从默认映像创建的 codespaces 将始终安装 JupyterLab。 有关默认映像的详细信息，请参阅“[开发容器简介](/zh/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#using-the-default-dev-container-configuration)”以及 [`devcontainers/images`](https://github.com/devcontainers/images/tree/main/src/universal) 仓库。 如果未在开发容器配置中使用默认映像，则可以通过将 `ghcr.io/devcontainers/features/python` 功能添加到 `devcontainer.json` 文件来安装 JupyterLab。 应该包括选项 `"installJupyterlab": true`。 有关详细信息，请参阅 `devcontainers/features` 存储库中 [`python`](https://github.com/devcontainers/features/tree/main/src/python#python-python) 功能的 README 文件。

   * 要通过 SSH 从命令行访问 codespace，请输入：

     ```shell copy
     gh codespace ssh
     ```

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

3. 要打开 codespace，请按 Enter<kbd></kbd>。

请参阅 GitHub CLI 手册中的 [`gh codespace code`](https://cli.github.com/manual/gh_codespace_code)。

</div>

## 其他阅读材料

* [适用于 Codespaces 组织的 REST API 终结点](/zh/rest/codespaces/organizations)