我的情况是2017年8月8日

如果您的用户页面为https://github.com/mgravell，则您的回购名称必须为 mgravell.github.io 在根目录下，创建一个index.html文件 在根目录下，创建一个文件夹docs，创建一个文件 文档下的CNAME(注意:没有像.txt这样的扩展名，确保你的文件 系统显示扩展) Gh-pages分支是可选的，master分支就足够了

更多信息:查看官方文档:https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

由于某种原因，GitHub页面的部署今天(2020年5月05日)停止工作。以前我没有任何html，只有md文件。我尝试创建一个index.html，它立即发布了页面。在删除index.html之后，发布将继续工作。

还有另一种情况:

使用组织页(不是项目页)，该组织页有一个名为<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 repo中的“Actions”选项卡看到构建过程中的错误消息。点击最新的“页面构建和部署”工作流显示了阻止发布的错误消息(my _config.yml中的一个简单错误)。

我所有的文件只有一次提交。我推送了一个空提交，刷新了页面，它工作了。

git commit --allow-empty -m "Trigger rebuild"
git push

如果这不起作用，正如@Hendrikto在评论中指出的那样，检查Github状态页面，并确保Github页面是可操作的。

今天又遇到了同样的问题。在我的情况下，我添加脚本作为模块，这导致HTTP 404试图获取文件时，部署与Github页面。我不得不改变我的捆扎机使它工作。

in the index.html file

DID NOT WORK:
<script type="module" src="./index.4b5c177027.js"></script>

WORKS:
<script src="./index.4b5c177027.js"></script>

最好的