一般 Jekyll 构建失败
一般构建失败不会生成包含特定文件和错误信息的电子邮件。 如果您收到的电子邮件只是说“页面构建失败”而没有进一步的详细信息，或者您的 GitHub Pages 站点在第一次推送后没有显示，请检查这些常见错误。
我们建议您在本地构建站点，以便排查一般 Jekyll 构建失败，例如语法或标记错误。
使用部署密钥推送
推送必须来自用户帐户。 如果使用部署密钥向组织的页面仓库推送，则不会触发构建。
但是，您可以将计算机用户设置为组织的成员。
不受支持的插件
GitHub 页面 服务器不会使用不受支持的插件进行构建。 将不受支持的插件纳入站点的唯一方法是：在本地生成站点，然后将站点的静态文件推送到 GitHub 页面 站点。 有关不受支持插件的列表以及如何将其纳入您的 GitHub 页面 站点，请参阅“添加 Jekyll 插件到 GitHub 页面 站点”。
来源设置
我们的构建服务器在构建页面站点时会覆盖 source 设置。 如果您在 _config.yml 文件中更改此设置，您的 GitHub 页面 站点可能无法正确构建。
使用持续集成服务
有些 CI 服务（例如 Travis CI）不会生成 gh-pages 分支，除非您明确将其列入白名单。 如果希望 GitHub 页面 站点集成 CI 服务，您需要在 CI 的配置文件中指定 gh-pages 分支。
例如，Travis CI 的文档建议将以下行添加到 .travis.yml 文件中：
branches:
only:
- gh-pages