预构建故障排除

有关 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 时， “预构建就绪”标签不会显示在选择机器类型的对话框中。这意味着预构建当前不可用。

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

如果您的分支没有专门启用预构建，但它从启用预构建的分支分支出来，它仍然可以从预构建中受益。但是，如果您的分支上的开发容器配置发生了更改，使其与基本分支上的配置不同，那么您的分支上将不再提供预构建。

以下是检查“ 特定分支未显示“预构建就绪”标签

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