配置 codespace 的自动删除

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

但是，由于 GitHub Codespaces 会产生存储费用，因此，你可能希望通过在 GitHub Codespaces 的个人设置中更改默认期限来减少保持期。有关存储费用的详细信息，请参阅 GitHub Codespaces 计费。

注意

无论你是否设置了个人 codespace 保持期，最好养成删除不再需要的 codespace 的习惯。请参阅“删除代码空间”。

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

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

每个 codespace 都有自身的保留期。因此，你可能会有保留期不同的代码空间。例如，如果：

你创建了一个 codespace，更改了你的默认保持期，然后创建了另一个 codespace。
你使用 GitHub CLI 创建了一个 codespace，并指定了一个不同的保持期。
你为由组织拥有的代码库创建了一个代码空间，该代码库在组织设置中配置了保留期。你创建的 codespace 的所有权显示在 Your codespaces 页上。

注意

保留期限以天为单位指定。一天表示一个 24 小时的期限，从停止 codespace 那一天的那一刻起。

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

在 GitHub 任意页面的右上角，单击你的个人资料照片，然后单击“ Settings”。1. 在边栏的“Code, planning, and automation”部分中，单击 “Codespaces”。
在“默认保留期”下，输入你希望代码空间在停止后默认保留的天数。

你可以在 0 到 30 天之间设置默认的保持期。

警告

将期限设置为 0 将导致 codespace 在停止时或由于处于非活动状态而超时时被立即删除。请参阅“设置 GitHub Codespaces 超时期限”。
单击“ 保存”。

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

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

可以检查某个 codespace 是否即将自动删除。

当处于非活动状态的 codespace 的保持期即将结束时，这将在 GitHub 上的 codespace 列表中指明：https://github.com/codespaces。

三个 Codespaces 列表的屏幕截图。其中第三个标记为“4 天后过期”，以深橙色边框突出显示。

你可能有一个 codespace，希望其保持期长于个人设置中定义的保持期。可使用“保留 codespace”选项实现此目的。选择此选项时，codespace 将会被无限期保留，直到您手动删除它为止。

注意

组织拥有的代码空间如果受组织保留策略影响，将无法使用“保留代码空间”选项。

如果 codespace 归个人 GitHub 帐户所有，则 codespace 会产生存储成本或使用包含的存储限额。因此，应注意无限期存储 codespace 的成本影响。请参阅“GitHub Codespaces 计费”。

在 GitHub 的左上角，选择，然后单击“ Codespaces”，转到 github.com/codespaces 上的“Your codespaces”页面****。
在要避免自动删除的 codespace 的右侧，单击“”，然后单击“ Keep codespace”****。

避免自动删除的 codespace 在 codespace 列表中用书签图标 () 表示。

代码空间列表部分的屏幕截图，显示了带有书签图标的代码空间。

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

若要在创建 codespace 时设置 codespace 保持期，请将 --retention-period 标志与 codespace create 子命令一起使用。按天数指定期限。期限必须介于 0 到 30 天之间。

gh codespace create --retention-period DAYS

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

注意

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

可以通过 Web 浏览器在 GitHub 上设置默认保持期。或者，如果使用 GitHub CLI 创建 codespace，则可以为该特定 codespace 设置保持期。有关详细信息，请单击上面相应的选项卡。

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

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

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

如果 codespace 即将接近保持期的末尾，则会包含一行，告知此期限何时到期。

        [AUTOTITLE](/codespaces/customizing-your-codespace)

        [AUTOTITLE](/codespaces/managing-your-codespaces)