昨天我遇到了同样的问题(在一个新建立的GitHub页面网站上出现404)。我尝试了很多方法，比如切换一个新的主题等。但它似乎对我的案子仍然不起作用。我最终通过将GitHub页面网站的分支切换到另一个分支来解决这个问题，单击保存。等一会儿再换回去。然后问题突然解决了。

此外，GitHub页面目前不支持Git LFS。因此，如果你在GitHub页面中有图像(或其他二进制资产)使用Git LFS提交，你将得到404不对这些文件。

这对于用Doxygen或类似工具生成的文档来说是很常见的。

这种情况下的解决方案就是不使用Git LFS提交这些文件。

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

在我的例子中，我有名称以_开头的文件夹(如_css和_js)， GH Pages根据Jekyll处理规则忽略这些文件夹。如果不使用Jekyll，解决方法是在根目录中放置一个名为.nojekyll的文件。否则，您可以从这些文件夹中删除下划线

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