关于 GitHub Pages 站点的 Jekyll 构建错误

如果在本地或 GitHub 上构建 GitHub Pages 站点发生 Jekyll 错误，你将收到一条错误消息，其中包含相关详细信息。

谁可以使用此功能？

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共存储库，以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和专用存储库。 有关详细信息，请参阅 GitHub 的计划。

GitHub Pages 现在使用 GitHub Actions 来执行 Jekyll 构建。 使用分支作为构建源时，如果要使用内置的 Jekyll 工作流，则必须在存储库中启用 GitHub Actions。 或者，如果 GitHub Actions 不可用或已禁用，则将 .nojekyll 文件添加到源分支的根目录将绕过 Jekyll 构建过程并直接部署内容。 有关启用 GitHub Actions 的详细信息，请参阅“管理存储库的 GitHub Actions 设置”。

本文内容

关于 Jekyll 构建错误

如果从分支发布，则将更改推送到站点的发布源后，有时，GitHub Pages 不会尝试生成站点。

  • 推送更改的人尚未验证他们的电子邮件地址。 有关详细信息，请参阅“验证电子邮件地址”。
  • 您使用部署密钥推送。 如果要自动推送到站点的仓库，您可以改为设置计算机用户。 有关详细信息，请参阅“管理部署密钥”。
  • 您使用的是未配置为构建发布源的 CI 服务。 例如，Travis CI 不会生成 gh-pages 分支，除非将分支添加到安全列表。 有关详细信息，请参阅 Travis CI 上的自定义生成或 CI 服务的文档。

Note

对站点的更改在推送到 GitHub 后，最长可能需要 10 分钟才会发布。

如果 Jekyll 尝试构建站点但遇到错误，你将收到一条构建错误消息。

有关排查生成错误的详细信息，请参阅“排查 GitHub Pages 站点的 Jekyll 构建错误”。

查看 GitHub Actions 的 Jekyll 构建错误消息

默认情况下，除非已将 GitHub Pages 网站配置为使用其他 CI 工具，否则 GitHub Pages 网站使用 GitHub Actions 工作流程运行构建和部署。 要查找潜在的构建错误，您可以通过查看仓库的工作流程运行来检查 GitHub Pages 站点的工作流程运行情况。 有关详细信息，请参阅“查看工作流程运行历史记录”。 有关如何在出现错误时重新运行工作流的详细信息，请参阅“重新运行工作流程和作业”。

在本地查看 Jekyll 构建错误消息

我们建议在本地测试站点，这样你可以在命令行上看到构建错误消息，并在更改推送到 GitHub 之前解决任何构建失败。 有关详细信息，请参阅“使用 Jekyll 在本地测试 GitHub Pages 站点”。

在拉取请求中查看 Jekyll 构建错误消息

如果从分支发布，当创建拉取请求来更新 GitHub 上的发布源时，拉取请求的“Checks”选项卡上会显示生成错误消息。**** 有关详细信息，请参阅“