# 删除代码空间

您可以删除不再需要的代码空间。

## 概述

GitHub Codespaces 在停止后自动删除，并在定义的天数内保持非活动状态。 创建 codespace 时，将设置每个 codespace 的保持期且不会更改。 默认保留期为 30 天。请参阅 [配置 codespace 的自动删除](/zh/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces?tool=webui)。

有多种方法可以手动删除 codespace:

* 在终端中使用 GitHub CLI 删除
* 在 Visual Studio Code
  中
* 在您的网络浏览器中

使用本文顶部的标签页，以显示关于每种删除 codespace 方法的说明。

> \[!NOTE]
> 无法在 JupyterLab 中删除 codespace。

## 为何应删除未使用的 codespace

存储代码空间会产生费用。 因此，应删除任何不再需要的 codespace。 请参阅“[GitHub Codespaces 计费](/zh/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)”。

可以创建的 codespace 数量和可以同时运行的 codespace 数量受到限制。 这些限制因多种因素而异。 如果达到最大 codespace 数并尝试创建另一个 codespace，则会显示一条消息，告知你必须删除现有 codespace，然后才能创建新的 codespace。

## 删除代码空间

<div class="ghd-tool webui">

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 的右侧，单击“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Codespace configuration" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>”，然后单击“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-trash" aria-label="trash" role="img"><path d="M11 1.75V3h2.25a.75.75 0 0 1 0 1.5H2.75a.75.75 0 0 1 0-1.5H5V1.75C5 .784 5.784 0 6.75 0h2.5C10.216 0 11 .784 11 1.75ZM4.496 6.675l.66 6.6a.25.25 0 0 0 .249.225h5.19a.25.25 0 0 0 .249-.225l.66-6.6a.75.75 0 0 1 1.492.149l-.66 6.6A1.748 1.748 0 0 1 10.595 15h-5.19a1.75 1.75 0 0 1-1.741-1.575l-.66-6.6a.75.75 0 1 1 1.492-.15ZM6.5 1.75V3h3V1.75a.25.25 0 0 0-.25-.25h-2.5a.25.25 0 0 0-.25.25Z"></path></svg> Delete”\*\*\*\*。

   ![codespace 列表的屏幕截图，显示其中一个 codespace 的下拉菜单，其中显示“删除”选项。](/assets/images/help/codespaces/delete-codespace.png)

</div>

> \[!NOTE]
> 你可能有预生成的 codespace 正在消耗额外的存储，但此仪表板上未显示。 若要删除它们，请按照“[删除预生成配置](/zh/codespaces/prebuilding-your-codespaces/managing-prebuilds#deleting-a-prebuild-configuration)”中的步骤操作。

<div class="ghd-tool vscode">

如你当前未在 codespace 中工作，可从 VS Code 内删除 codespace。

1. 在 VS Code 的活动栏中，单击“远程资源管理器”图标。

   ![活动栏的屏幕截图。 “远程资源管理器”边栏图标（一个被圆圈覆盖的矩形）以橙色边框突出显示。](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.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: 详细信息”。
2. 在“GitHub Codespaces”下，右键单击要删除的 codespace。
3. 单击“删除 codespace”。

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> 若要详细了解 GitHub CLI，请参阅“[关于 GitHub CLI](/zh/github-cli/github-cli/about-github-cli)”。

若要删除代码空间，请使用 `gh codespace delete` 子命令，然后从显示的列表中选择一个代码空间。

```shell
gh codespace delete
```

如果您有未保存的更改，系统将提示您确认删除。 可以使用 `--force` 标志强制删除，从而避免出现此提示。

有关此命令的详细信息，请参阅 [GitHub CLI 手册](https://cli.github.com/manual/gh_codespace_delete)。

</div>

## 批量删除代码空间

<div class="ghd-tool webui">

可以使用 GitHub CLI 通过单个命令删除多个或所有 codespace。 有关详细信息，请单击此页面顶部附近的“GitHub CLI”选项卡。

</div>

<div class="ghd-tool vscode">

可以使用 GitHub CLI 通过单个命令删除多个或所有 codespace。 有关详细信息，请单击此页面顶部附近的“GitHub CLI”选项卡。

</div>

<div class="ghd-tool cli">

可以使用单个命令并在 `gh codespace delete` 后使用以下标志之一来删除多个或所有 codespace：

```
          `--all` - 删除所有 codespace。

          `--repo REPOSITORY` - 删除此存储库的所有 codespace。 或者与 `--days` 标志一起使用，按 codespace 的存在时长进行筛选。

          `--days NUMBER` - 删除早于指定天数的所有 codespace。 可以与 `--repo` 标志一起使用。
```

默认情况下，系统会提示确认删除包含未保存更改的任何 codespace。 可以使用 `--force` 标志跳过此确认。

### 示例

删除 `octo-org/octo-repo` 存储库 7 天前创建的所有 codespace。

```shell
gh codespace delete --repo octo-org/octo-repo --days 7
```

</div>

## 删除组织中的 codespace

作为组织所有者，可以使用 GitHub CLI 删除组织中的任何 codespace。

<div class="ghd-tool webui">

有关详细信息，请单击此页面顶部附近的“GitHub CLI”选项卡。

</div>

<div class="ghd-tool vscode">

有关详细信息，请单击此页面顶部附近的“GitHub CLI”选项卡。

</div>

<div class="ghd-tool cli">

1. 输入以下命令之一以显示 codespace 列表。
   * `gh codespace delete --org ORGANIZATION` - 列出指定组织中的当前代码空间。
   * `gh codespace delete --org ORGANIZATION --user USER` - 仅列出指定用户创建的 codespace。
     你必须是指定组织的所有者。
2. 在 codespace 列表中，导航到要删除的 codespace。
3. 要删除选定的 codespace，请按 <kbd>Enter</kbd>。

   如果 codespace 包含未保存的更改，系统会提示确认删除。

</div>

还可以使用 REST API 删除组织的 codespace。 请参阅“[适用于 Codespaces 组织的 REST API 终结点](/zh/rest/codespaces/organizations#delete-a-codespace-from-the-organization)”。

## 其他阅读材料

* [了解代码空间的生命周期](/zh/codespaces/about-codespaces/understanding-the-codespace-lifecycle)
* [配置 codespace 的自动删除](/zh/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces)
* [限制 codespaces 的保留期](/zh/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)