配置代码空间的自动删除

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

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

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

自动删除无论代码空间是否包含未推送的更改都会发生。要防止自动删除代码空间，只需再次打开代码空间即可。每次连接到代码空间时，保留期限都会重置，并且代码空间停止时，保留倒计时会重新开始。

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

每个代码空间都有自己的保留期限。因此，您可能拥有保留期限不同的代码空间。例如，如果

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

为您的代码空间设置默认保留期限

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

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

**警告**：将期限设置为 0 将导致您的 codespace 在您停止它们或因 inactivity 超时时立即删除。有关更多信息，请参阅“设置 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”选项不适用于受组织保留策略影响的组织拥有的 codespace。

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

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

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

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

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

要设置创建 Codespace 时的 Codespace 保留期限，请在 codespace create 子命令中使用 --retention-period 标志。以天为单位指定期限。期限必须在 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 的信息。

如果 Codespace 即将到期，则会显示一行文字，说明 Codespace 的保留期将在何时到期。