对我来说，关键是认识到你可以通过到你的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分支按预期发布。

这个错误的另一种变体:

我在一个教程之后建立了我的第一个Github页面，但给了文件自述。Md，在我看来，更有意义的名字:欢迎。Md。

这是一个致命的错误:

我们将使用您的README文件作为网站的索引，如果您没有 索引。Md(或index.html)，与您浏览到一个 GitHub上的存储库。

从发布GitHub页面，现在像1,2,3一样简单

然后，我可以使用Repository / Settings / GitHub Pages下指定的published at链接访问我的网站页面，后面跟着welcome.html或更短的欢迎。

在我的例子中，我的存储库是私有的。将存储库设为公共并再次执行所有步骤。

就我而言，上面的建议都是正确的。我有大多数页面工作，除了少数返回404，即使降价文件在那里，他们似乎是正确的。以下是我在这几页上看到的东西:

在一个页面上，有一些特殊字符不是UTF-8的一部分，我想这就是为什么GitHub页面无法呈现它们的原因。更新/删除这些字符并提交新的提交可以修复它。 在另一个页面上，我发现标题周围有撇号，我删除了它们，页面内容开始显示正常

在我的情况下，在react中有必要选择gh-pages分支: