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

我也有同样的问题后分叉回购与gh-pages分支。我可以通过简单地将一个新的提交(只是index.html中的空白)推到我的fork的gh-pages分支来修复。

我不得不将我的回购重命名为一个随机的名字，然后重命名为它原来的名字，让它工作。

看起来可能是GH Pages漏洞。

如果你使用的是Angular这样的框架，你可能需要设置基本的href路径: https://stackoverflow.com/a/54409380/1585161

使用Angular CLI: ng build——baseHref="/users/"

或者更一般地说:<base href="/users/">

还要确保图像资产以。/assets开头，而不是/assets

我的情况是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，即使降价文件在那里，他们似乎是正确的。以下是我在这几页上看到的东西:

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