配置代码空间的自动删除

默认情况下，GitHub Codespaces 在停止后且处于不活动状态 30 天后会自动删除。

但是，由于 GitHub Codespaces 会产生存储费用，您可能希望通过更改 GitHub Codespaces 个人设置中的默认保留期来缩短保留期。有关存储费用的更多信息，请参阅“关于 GitHub Codespaces 的计费”。

注意：无论您是否设置了个人 codespace 保留期，养成删除不再需要的 codespace 的习惯都是一个好主意。有关更多信息，请参阅“删除 codespace”。

自动删除与 codespace 是否包含未推送的更改无关。要防止 codespace 自动删除，只需再次打开 codespace。每次连接到 codespace 时，保留期都会重置，并且当 codespace 停止时，保留倒计时会重新开始。

如果存储库属于某个组织，组织所有者可能已为整个组织设置了保留期。如果此期限短于您个人设置中的默认保留期限，则组织保留期限将适用于您为此存储库创建的 codespace。有关更多信息，请参阅“限制 codespace 的保留期”。

每个 codespace 都有自己的保留期。因此，您可能拥有保留期不同的 codespace。例如，如果

您创建了一个 codespace，更改了默认保留期，然后创建了另一个 codespace。
您使用 GitHub CLI 创建了一个 codespace 并指定了不同的保留期。
您为组织拥有的存储库创建了一个 codespace，该存储库在组织设置中配置了保留期。您创建的 codespace 的所有权显示在“您的 codespace”页面上。

注意：保留期以天为单位。一天代表一个 24 小时的时间段，从您停止 codespace 的时间开始。

为您的 codespace 设置默认保留期

在 GitHub 上任何页面的右上角，单击您的个人资料照片，然后单击设置。
在侧边栏的“代码、计划和自动化”部分，点击 ** Codespaces**。
在“默认保留期限”下，输入您希望在 Codespaces 停止后默认保留的天数。

您可以将默认保留期限设置为 0 到 30 天。

**警告**：将期限设置为 0 将导致您的 Codespaces 在您停止它们时或由于不活动而超时时立即删除。有关更多信息，请参阅“设置 GitHub Codespaces 的超时期限”。
点击 **保存**。

使用 GitHub CLI 创建 Codespace 时，您可以覆盖此默认值。如果您在指定了较短保留期限的组织中创建 Codespace，则组织级别值将覆盖您的个人设置。

如果您设置的保留期限超过一天，您将在其删除前一天收到电子邮件通知。

您可以检查 Codespace 是否即将自动删除。

当不活动的 Codespace 接近其保留期限结束时，这将在您在 GitHub 上的 Codespace 列表中显示，地址为 https://github.com/codespaces。

Screenshot of a list of three codespaces. The third of these is labeled "Expiring in 4 days" which is highlighted with a dark orange outline.

您可能有一个 Codespace，您希望将其保留的时间比您的个人设置中定义的保留期限更长。您可以使用“保留 Codespace”选项来实现。当您选择此选项时，您的 Codespace 将无限期保留，直到您手动删除它。

**注意**：“保留 Codespace”选项不适用于受组织保留策略影响的组织拥有的 Codespaces。

Codespaces 会产生存储费用，或者如果 Codespace 由您的个人 GitHub 帐户拥有，则会消耗您的包含存储配额。因此，您应该了解无限期存储 Codespace 的成本影响。有关更多信息，请参阅“关于 GitHub Codespaces 的计费”。

在 GitHub.com 的左上角，选择，然后点击 **Codespaces** 将带您到“您的 Codespaces”页面，地址为 github.com/codespaces。
在您要免除自动删除的 Codespace 右侧，点击，然后点击 保留 Codespace。

您已豁免自动删除的 Codespace 会在您的 Codespace 列表中用书签图标（).

Screenshot of a section of the codespaces list, showing a codespace labeled with the bookmark icon.

如果您已安装 GitHub CLI，则可以使用它来操作 GitHub Codespace。有关 GitHub CLI 安装说明，请参阅 GitHub CLI 存储库。

要设置创建 Codespace 时的 Codespace 保留期限，请使用 --retention-period 标志和 codespace create 子命令。以天为单位指定期限。期限必须介于 0 到 30 天之间。

gh codespace create --retention-period DAYS

如果您在创建 Codespace 时未指定保留期限，则将使用您的默认保留期限或组织保留期限，以较短者为准。有关设置默认保留期限的信息，请单击此页面上的“Web 浏览器”选项卡。

要详细了解 GitHub CLI，请参阅“关于 GitHub CLI”。

您可以在 GitHub.com 上的 Web 浏览器中设置您的默认保留期限。或者，如果您使用 GitHub CLI 创建 Codespace，则可以为该特定 Codespace 设置保留期限。有关更多信息，请单击上面的相应选项卡。

您可以在 Visual Studio Code 桌面应用程序中检查 Codespace 是否即将自动删除。

在 VS Code 中，在活动栏中，单击远程资源管理器图标。
注意：如果活动栏中未显示远程资源管理器
1. 访问命令面板。例如，按 Shift+Command+P（Mac）/ Ctrl+Shift+P（Windows/Linux）。
2. 键入：details。
3. 单击Codespaces：详细信息。
从远程资源管理器右上角的下拉菜单中选择GitHub Codespaces（如果尚未选择）。
在“GITHUB CODESPACES”下，将鼠标指针悬停在您感兴趣的 Codespace 上。将显示一个弹出框，其中显示有关 Codespace 的信息。

如果代码空间即将到期，会有一行文字提示代码空间的到期时间。