充分利用您的免费额度

了解个人帐户包含的 GitHub Codespaces 免费使用情况。

本文内容

个人 GitHub 帐户每月包含一定额度的 GitHub Codespaces 免费使用配额。

注意

GitHub Codespaces 的免费使用仅限于个人帐户，组织或企业帐户不包含。

Codespaces 使用分为两种类型：计算资源和存储空间。在您的每月计费周期内，当您使用 Codespaces 时，您的计算资源和存储空间使用量将从您的个人 GitHub 帐户中包含的免费使用配额中扣除，直到计算资源或存储空间用完为止。一旦其中一个限制达到，您的 GitHub Codespaces 使用将受到限制，除非您已设置支出限额和付款方式。在您的配额续订之前，您将无法创建新的 Codespaces 或打开您需要付费的现有 Codespaces。如果您有权访问由支付 GitHub Codespaces 使用费的组织拥有的仓库，您可能仍然能够为这些仓库创建 Codespaces。

您每月个人帐户提供的免费使用量旨在让您免费贡献开源项目或进行副项目工作。它并非旨在让您免费进行日常工作。

关于 Codespaces 计算资源

Codespaces 计算以核心小时计，它是 Codespace 运行时间与 Codespace 机器类型的乘数之和：例如，2 核机器的乘数为 2，8 核机器的乘数为 8。创建或启动 Codespace 时，它即变为活动状态。停止、删除 Codespace 或 Codespace 自动停止或删除时，它将停止处于活动状态。

默认空闲超时时间为 30 分钟，在此时间段内无活动后 Codespace 将停止。如有需要，您可以缩短此时间。请参阅《关于 GitHub Codespaces 计算使用费》一文中的“关于计算使用费”部分。

关于 Codespaces 存储

您可以在 github.com/codespaces 上的“您的 Codespaces”页面查看每个 Codespaces 的存储使用情况。

Screenshot of a list of three codespaces on the https://github.com/codespaces page."

注意

如果 Codespace 的开发容器是根据默认镜像构建的，则此页面上显示的 Codespace 大小不包括基础开发容器的大小。基础开发容器的存储空间免费提供。请参阅《基础开发容器的存储使用情况》。

出于计费目的，Codespaces 存储以 GB-月计。这是一个累积度量值，表示每个 Codespace 从创建到删除所消耗的总存储量，以及预构建的存储量。请参阅《关于 GitHub Codespaces 存储使用费》一文中的“存储使用费计费”部分。

我的月度存储空间去哪里了？

删除您不使用的 Codespaces 将避免不必要地消耗个人帐户中包含的免费存储空间。但是，如果您已设置预构建配置，则在您的每月计费周期中，您包含的存储空间可能会继续减少。

虽然预构建不会列在“您的 Codespaces”页面上，但为存储库创建的预构建会消耗存储空间，即使您当前没有该存储库的任何 Codespaces 也是如此。为避免这种情况，您可以删除您设置的预构建配置。请参阅《关于 GitHub Codespaces 预构建》和《管理预构建》。

了解您的 Codespaces 使用情况

您可以在 GitHub 设置中查看当前每月计费周期的累积 GitHub Codespaces 使用情况。请参阅《查看您的 GitHub Codespaces 使用情况》。

Screenshot of the "Codespaces" section of the billing page showing figures for "Usage hours" and "Storage."

您可以展开“使用小时数”和“存储空间”部分以获取更多信息，例如查看预构建使用了多少消耗的存储空间。

如需更具体的信息（例如，您想知道哪些存储库具有正在消耗存储空间的预构建），您可以生成使用情况报告。使用情况报告是一个 CSV 文件，会通过电子邮件发送给您。有关如何生成使用情况报告的更多信息，请参阅《查看您的 GitHub Codespaces 使用情况》。

要查看您的 Codespaces 使用情况，请过滤报告以仅显示在Product列中提到“Codespaces”的行。

Screenshot of a usage report in Microsoft Excel. All of the entries in the "Product" column read "Codespaces - Linux."

基础开发容器的存储使用情况

如果您没有将开发容器配置添加到您的存储库，或者您的配置未指定要使用的开发容器镜像，则 GitHub 将根据默认 Linux 镜像创建容器。根据默认开发容器镜像构建的基础开发容器的存储空间免费提供，不会消耗您包含的存储空间。您的存储使用情况将仅基于您存储库中的文件，以及您随后添加到 Codespace 的任何文件，包括 VS Code 扩展。如果您使用替代基本镜像，则生成的容器和 Codespace 中的所有文件都将计入已使用的存储空间。有关默认 Linux 镜像中包含的内容的信息，请参阅devcontainers/images存储库。

您可以检查用于创建 Codespace 的开发容器的镜像。在 Codespace 的终端中，运行以下命令。

Shell
devcontainer-info

如果当前 Codespace 的开发容器是根据默认镜像构建的，则此命令的输出将包含以下信息。

- Definition ID: universal
- Source code repository: https://github.com/devcontainers/images

充分利用允许使用量的技巧

  • 您的 Codespaces 在运行时会消耗计算使用量。如果您未使用 Codespace，则停止 Codespace 可以防止不必要的计算使用量。请参阅《停止和启动 Codespace》。

  • 您可以在个人设置中将 Codespaces 的空闲超时时间缩短到少于默认的 30 分钟。这将缩短 Codespaces 自动停止之前的非活动时间段。这可以节省计算使用量。请参阅《设置 GitHub Codespaces 的超时时间段》。

  • 您的 Codespaces 在存在时会消耗存储空间。您应该删除您已完成使用并且知道将不再使用的 Codespace。请参阅《删除 Codespace》。

    注意

    删除 Codespace 不会减少您本月计费的已使用存储空间量，因为这是一个累积数字。

  • 配置您的保留期，以确保您忘记删除的 Codespaces 会自动删除。默认保留期为 30 天。请参阅《配置 Codespaces 的自动删除》。

  • Visual Studio Code 扩展会消耗存储空间。确保您只安装需要的扩展。您可以在 Codespace 中运行以下命令来了解扩展使用了多少空间。

    Shell
    du -h -s ~/.vscode-remote/extensions

  • 您可以通过访问 GitHub 上的计费页面 https://github.com/settings/billing 并查看“Codespaces”部分中的数字来监控您的计算和存储使用情况。

    注意

    存储空间按小时计算，并添加到您现有的存储使用量中。因此，在您为期一个月的计费周期内，消耗的存储空间是累积的。这意味着在计费期间，您在计费页面上看到的数值只会增加或保持不变。当新的计费周期开始时，使用情况将重置为零。删除 Codespace 或预构建不会减少本月的使用情况数字，但会降低存储使用量累积的速度。

  • 确保您只针对所需数量的版本和区域使用预构建。请参阅《关于 GitHub Codespaces 预构建》和《关于 GitHub Codespaces 计费》。

    注意

    如果您的包含的存储使用量已用尽，则新的预构建将被禁用，直到您设置支出限额或您的包含的使用配额续订。

  • 如果您已在存储库的设置中配置了预构建，但您没有为该存储库使用 GitHub Codespaces，请考虑删除预构建配置，以避免该存储库的预构建不必要地消耗您包含的存储配额。删除预构建配置时，所有关联的预构建都将被删除，从而从那时起减少您的存储消耗。请参阅《管理预构建》。

    您可以在存储库设置的“Codespaces”页面中检查预构建配置。请参阅《配置预构建》。

    或者，您可以通过查看使用情况报告来检查哪些存储库具有预构建。请参阅上面《了解您的 Codespaces 使用情况》。

  • 根据 Codespaces 的默认开发容器镜像构建的容器的存储空间免费提供，不会减少您包含的存储空间。因此，您可以通过在开发容器配置中使用默认镜像而不是指定更专业的镜像来避免开发容器消耗您的存储配额。请参阅《开发容器简介》和上面《基础开发容器的存储使用情况》。