配置代码空间的自动删除

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

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

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

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

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

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

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

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

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

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

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

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

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

您可以检查代码空间是否即将自动删除。

当一个不活动的代码空间接近其保留期限结束时，这将在您在 GitHub 上的代码空间列表中显示，网址为 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.

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

注意：“保留代码空间”选项不适用于受组织保留策略影响的组织拥有的代码空间。

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

您已免除自动删除的代码空间将在您的代码空间列表中用书签图标 ().

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

如果您已安装 GitHub CLI，则可以使用它来操作 GitHub 代码空间。有关 GitHub CLI 安装说明，请参阅 GitHub CLI 仓库。

要设置创建代码空间时的代码空间保留期限，请使用 --retention-period 标志与 codespace create 子命令一起使用。以天为单位指定期限。期限必须在 0 到 30 天之间。

gh codespace create --retention-period DAYS

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

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

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

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

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

如果代码空间即将到期，则会显示一行，告知该期限何时到期。