对我来说，关键是认识到你可以通过到你的github repo中的“Actions”选项卡看到构建过程中的错误消息。点击最新的“页面构建和部署”工作流显示了阻止发布的错误消息(my _config.yml中的一个简单错误)。

还有另一种情况:

使用组织页(不是项目页)，该组织页有一个名为<orgname>.github.io的存储库 源文档作为主分支中的标记(asciidoc) 特拉维斯CI拉源文档文件从主和推动生成的html文件到gh-pages分支

gh-pages分支使用生成的html页面进行更新。GitHub Environment选项卡提供了到组织页面的链接。点击它会出现404。

根据 https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

具有这种类型存储库名称的用户页和组织页为 只从主分支发布

如果我理解正确的话，如果你创建的是用户或组织网站而不是项目网站，GitHub页面将不会从gh-pages分支发布。

我重命名了我的repo，使其成为Project站点而不是Organization站点，然后gh-pages分支按预期发布。

在一次私人回购中，当我第一次添加并将我的gh-pages分支推到github时，github页面的设置自动更改为指示将发布gh-pages分支，但github没有绿色或蓝色条。IO url，没有自定义域选项。

直到我将源代码切换到master，并快速将源代码切换回gh-pages，它才真正更新了包含已发布url的绿色条。

如果还没有，请在GitHub Pages设置选项卡中选择Jekyll主题。显然，即使您的Pages站点没有使用Jekyll，这也是必需的。

你的GitHub页面可以在http://roine.github.io/p1而不是http://roine.github.com/p1。

顺便说一下，您可以修改项目的描述。

在我的情况下，这是我最近为GitHub页面设置了一个自定义域，但GitHub已经忘记了我的自定义域下(repo)<name>. GitHub。io / Settings / Pages。

我再次添加了自定义域，然后它立即开始工作。