充分利用你的包含使用情况

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

注意：仅个人帐户包含 GitHub Codespaces 的免费使用权限。组织或企业帐户不包含此权限。

Codespaces 使用有两种类型：计算和存储。在您的每月计费期间，随着您使用 Codespaces，您的计算和存储使用情况将从您的个人 GitHub 帐户中包含的免费使用配额中扣除，直到计算或存储被消耗掉。一旦达到其中一个限制，您的 GitHub Codespaces 使用将受到限制，除非您已设置支出限额和付款方式。在您的配额续订之前，您将无法创建新的 Codespaces 或打开您将为此付费的现有 Codespaces。如果您有权访问由支付 GitHub Codespaces 使用费用的组织拥有的存储库，您仍然可以为这些存储库创建 Codespaces。

每月在您的个人帐户上提供的免费使用量旨在让您免费做出开源贡献或从事副业。它并不是为了让您免费完成日常工作。

关于 Codespaces 计算

Codespaces 计算以核心小时为单位，这是 Codespaces 处于活动状态的时间与 Codespaces 机器类型的乘数之和：例如，2 核机器的乘数为 2，8 核机器的乘数为 8。当您创建或启动 Codespaces 时，Codespaces 会变为活动状态。当您停止或删除 Codespaces，或当它被自动停止或删除时，Codespaces 将停止处于活动状态。

默认空闲超时（在一段时间不活动后停止 Codespaces）为 30 分钟。如果需要，您可以减少此时间。有关更多信息，请参阅“关于 GitHub Codespaces 计费”部分中的“关于计算使用情况计费”。

关于 Codespaces 存储

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

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

注意：如果代码空间的开发容器是从默认映像构建的，此页面上显示的代码空间大小不包括基本开发容器的大小。基本开发容器的存储是免费提供的。有关更多信息，请参阅“基本开发容器的存储使用情况”。

出于计费目的，代码空间存储以 GB-月为单位进行计算。这是从创建到删除期间每个代码空间消耗的总存储以及预构建存储的累积度量。有关更多信息，请参阅“关于 GitHub 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

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 扩展会消耗存储空间。请确保只安装必要的扩展。可以通过在代码空间中运行此命令来了解扩展使用了多少空间。
Shell
```
du -h -s ~/.vscode-remote/extensions
```
```
du -h -s ~/.vscode-remote/extensions
```
通过访问 GitHub.com 上的计费页面 https://github.com/settings/billing 并查看“代码空间”部分中的数据来监控计算和存储使用情况。

注意：存储空间按小时计算，并添加到现有存储使用情况中。因此，消耗的存储空间在整个月度计费周期内累积。这意味着，在计费期间，计费页面上显示的值只会增加或保持不变。当新的计费周期开始时，使用情况将重置为零。删除代码空间或预构建不会减少当月的使用量，但会降低存储使用量累积的速度。
确保仅针对所需的版本和区域使用预构建。有关详细信息，请参阅“关于 GitHub Codespaces 预构建”和“关于 GitHub Codespaces 计费”。

注意：如果已用尽包含的存储使用量，则在您设置支出限额或包含的使用量配额续订之前，新的预构建将被禁用。
如果您已在存储库的设置中配置了预构建，但您没有针对该存储库使用 GitHub Codespaces，请考虑删除预构建配置，以避免该存储库的预构建不必要地消耗您的包含存储配额。当您删除预构建配置时，所有关联的预构建都将被删除，从而从那时起减少您的存储消耗。有关详细信息，请参阅“管理预构建”。

您可以在存储库设置的“Codespaces”页面中查看预构建配置。有关详细信息，请参阅“配置预构建”。

或者，您可以通过查看使用情况报告来检查哪些存储库有预构建。有关详细信息，请参阅上面的“了解您的 Codespaces 使用情况”。
为 Codespaces 构建的默认开发容器映像的容器存储是免费的，并且不会减少您的包含存储。因此，您可以通过在开发容器配置中使用默认映像，而不是指定更专门的映像，来避免您的存储限额被您的开发容器消耗。有关详细信息，请参阅上面的“开发容器简介”和“基本开发容器的存储使用情况”。