对预构建进行故障排除

有关 GitHub Codespaces 预生成的详细信息，请参阅 AUTOTITLE。

检查是否从预生成创建 codespace？

创建 codespace 时，可选择要使用的虚拟机类型。如果预构建可用于该类型的虚拟机，其旁边会显示“ Prebuild ready”。

可用机器类型的列表的屏幕截图：2 核、4 核、8 核、16 核和 32 核，全部标记为“预建就绪”。

如果将 GitHub Codespaces 编辑器首选项设置为“Visual Studio Code for Web”，则“设置 codespace”页面将显示“找到预生成 codespace”消息（如果正在使用预生成）。

“设置您的代码空间”页的屏幕截图，包含以下文本：“找到预生成的代码空间。” 下载图像”。

同样，如果编辑器首选项为“VS Code”，则在创建新 codespace 时，集成终端将包含“你位于存储库预生成配置定义的预生成 codespace 上”消息。有关详细信息，请参阅“AUTOTITLE”。

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

Shell

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

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

如果 codespace 是使用预生成创建的，则返回。

或者，如果未安装 GitHub CLI ()，您可以使用以下命令。如果 codespace 是从预生成创建的，该命令将返回：

Shell

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

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

检查预生成使用情况

可以在存储库设置的“Codespaces”页中检查存储库是否正在使用预生成。

可通过查看个人或组织帐户的计费数据，检查当前计费周期中的预生成占用的存储空间。还可以生成使用情况报告，以查看哪些存储库一直在使用预生成。有关详细信息，请参阅“AUTOTITLE”。

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

你可能会注意到，有时，当从支持预生成的分支创建新的 codespace 时，选择计算机类型的对话框中不会显示“ 预生成已准备”标签。这意味着预生成当前不可用。

默认情况下，每次推送到启用了预构建的分支时，预构建都会更新。如果推送涉及对开发容器配置的更改，则在进行更新时，将从计算机类型列表中移除“ Prebuild Ready”标签。在此期间，仍然可以在没有预生成环境的情况下创建代码空间。如果需要，可将预生成设置为仅在对开发容器配置文件进行更改时更新，或仅按自定义计划更新，从而减少预生成不可用于存储库的情况。有关详细信息，请参阅“AUTOTITLE”。

如果你的分支未明确启用预生成，但它是从已启用预生成的分支派生出来的，它仍然可能会从中受益。但是，如果分支上的开发容器配置已更改，变得与基础分支上的配置不同，则分支上将不再提供预生成。

如果特定分支未显示“ Prebuild Ready”标签，请检查以下事项：

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