预构建疑难解答

有关 GitHub Codespaces 预构建的更多信息，请参阅“预构建 Codespaces”。

如何检查 Codespace 是否是从预构建创建的？

创建 Codespace 时，您可以选择要使用的虚拟机的类型。如果虚拟机的类型有可用的预构建，则“预构建就绪”会显示在其旁边。

Screenshot of a list of available machine types: 2, 4, 8, 16, and 32 core, all labeled "Prebuild ready."

如果您的 GitHub Codespaces 编辑器首选项设置为“Visual Studio Code for Web”，则如果正在使用预构建，“设置 Codespace”页面将显示消息“找到预构建 Codespace”。

Screenshot of the "Setting up your codespace" page, with the text: "Prebuilt codespace found. Downloading image."

同样，如果您的编辑器首选项为“VS Code”，则在创建新的 Codespace 时，集成终端将包含消息“您位于存储库的预构建配置定义的预构建 Codespace 上”。有关更多信息，请参阅“设置 GitHub Codespaces 的默认编辑器”。

创建 Codespace 后，您可以通过在终端中运行以下 GitHub CLI 命令来检查它是否是从预构建创建的

Shell

gh api /user/codespaces/$CODESPACE_NAME --jq .prebuild

gh api /user/codespaces/$CODESPACE_NAME --jq .prebuild

如果 Codespace 是使用预构建创建的，则返回 true。

或者，如果未安装 GitHub CLI (gh)，则可以使用以下命令，如果 Codespace 是从预构建创建的，则返回 createFromPrebuild

Shell

cat /workspaces/.codespaces/shared/environment-variables.json | jq '.ACTION_NAME'

cat /workspaces/.codespaces/shared/environment-variables.json | jq '.ACTION_NAME'

检查预构建的使用情况

您可以在存储库设置的“Codespaces”页面中检查存储库是否正在使用预构建。

您可以通过查看个人或组织帐户的计费数据来检查预构建在您当前计费周期中消耗了多少存储空间。您还可以生成使用情况报告以查看哪些存储库一直在使用预构建。有关更多信息，请参阅“查看 GitHub Codespaces 使用情况”。

“预构建就绪”标签有时会丢失

您可能会注意到，有时，当您从启用预构建的分支创建新的 Codespace 时，“预构建就绪”标签不会显示在选择机器类型的对话框中。这意味着当前无法使用预构建。

默认情况下，每次您推送到启用了预构建的分支时，都会更新预构建。如果推送涉及对开发容器配置的更改，则在更新进行期间，将从机器类型列表中删除“预构建就绪”标签。在此期间，您仍然可以在没有预构建的情况下创建 Codespaces。如果需要，您可以减少存储库中预构建不可用的情况，方法是将预构建设置为仅在您更改开发容器配置文件时或仅根据自定义计划进行更新。有关更多信息，请参阅“配置预构建”。

如果您的分支未专门启用预构建，但如果它从启用了预构建的分支分支而来，它可能仍然会受益于预构建。但是，如果在您的分支上更改了开发容器配置，使其与基础分支上的配置不同，则您的分支上将不再提供预构建。

以下是如果“预构建就绪”标签未显示在特定分支上的检查事项

确认此分支存在预构建配置。如果您不是存储库管理员，则需要联系管理员以确认这一点。
确认预构建配置包含您的区域。
检查最近是否将开发容器配置的更改推送到启用了预构建的分支。如果是这样，您通常需要等到此推送的预构建工作流运行完成才能再次使用预构建。
如果最近未进行任何配置更改，请转到存储库的“**操作**”选项卡，单击** Codespaces 预构建**，在工作流列表中，并检查分支的预构建工作流运行是否成功。如果工作流的最新运行失败，并且这些失败运行中的一个或多个包含对开发容器配置的更改，则关联分支将没有可用的预构建。