还有另一种情况:

使用组织页(不是项目页)，该组织页有一个名为<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 page (https://eq19.github.io/)上的404页，但它保持了404'ing。

最后我发现我的浏览器几乎无法保持10分钟的缓存。

只需将/index.html添加到URL的末尾，它就会出现并解决这个问题。

https://username.github.io/{repoName}/index.html

我也面临着同样的问题，在尝试了上面提到的大多数方法后，我都无法得到解决方案。在我的情况下，由于Github更改主分支的名称的问题。

进入设置->进入GitHub页面部分，并将分支更改为main:

to

保存它，并选择一个主题，网站是实时的。

我的情况是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/

我也遇到了这个问题(404)，根本原因是我的文件名为INDEX.md。我在Windows上开发，我的本地Jekyll网站工作正常(因为Windows默认不区分文件名大小写)。当推送到Github时，它不起作用。有一次我重命名了INDEX。Md到索引。Md，一切都很顺利。

我在看YT的视频。因此，当我在终端上运行该命令时，它已经将代码推到了gh-pages分支。然后我推到主分支。它给了我404错误。

然后我将分支切换到master，然后再次恢复到gh-pages，现在错误消失了。它指向index.html，即使它不在URL中。