我在使用typedocs时遇到了这个问题。README。md工作，但没有实际的文档由我的文档字符串显示，我只是得到了一个404 Github页面屏幕。

要解决这个问题，只需在你的/docs目录(或任何你生成文档的地方)中放置一个空文件，并将其命名为.nojekyll

为了确认，你的文件结构现在应该看起来像:

./docs/.nojekyll  # plus all your generated docs

把这个推到你的远程Github回购和你的链接等现在应该工作。

同时确保你在你的Github设置中选择了:

Settings -> Github Pages -> Source -> master brach /docs folder

根据你的文档框架，你可能必须在每次更新你的文档时重新创建这个文件，这是一个使用typedocs和每次在包中创建.nojekyll文件的例子。json文件:

# package.json

      "scripts": {
        "typedoc": "typedoc --out docs src && touch docs/.nojekyll"
      },

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

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

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

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

在我的情况下，浏览器有我的应用程序以前的缓存版本。为了避免获得缓存版本，访问你的url使用一个随机查询字符串:

https://{{your-username}}.github.io/{{your-repository}}?randomquery

对我来说，关键是认识到你可以通过到你的github repo中的“Actions”选项卡看到构建过程中的错误消息。点击最新的“页面构建和部署”工作流显示了阻止发布的错误消息(my _config.yml中的一个简单错误)。

今天又遇到了同样的问题。在我的情况下，我添加脚本作为模块，这导致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>

最好的