配置代码空间的自动删除

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

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

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

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

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

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

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

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

在 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，"保留 Codespace" 选项不可用。

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

在 GitHub.com 的左上角，选择，然后单击 Codespaces 以转到 github.com/codespaces 上的“您的 Codespace”页面。
在您要免除自动删除的 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 的信息。

如果 Codespace 即将到期，将显示一条说明此期限何时到期的行。