Github Pages 站点未检测到 index.html [关闭]答案

【问题标题】：Github Pages site not detecting index.html [closed]Github Pages 站点未检测到 index.html [关闭]
【发布时间】：2018-01-03 21:10:11
【问题描述】：

我创建了一个 GitHub 页面存储库。出于某种原因，当我命名它时 https://[username].github.io，它不起作用，但是当我将它命名为 https://[username].github.io/index.html 时它起作用了。

为什么？

【问题讨论】：

您是否在该存储库的设置中启用了它？
什么意思？如果我将 index.html 作为后缀，我可以访问它。 github上有没有设置可以做到这一点？
它是如何随机开始工作的。没有附加 index.html 的 url。也许只是设置生效需要时间？
“当我命名它时”是什么意思？ “它”是什么？
通过将baseurl: / 属性添加到_config.yml 来解决问题

标签： html github github-pages

【解决方案1】：

它已自动修复。我只需要等待一段时间让设置生效。

【讨论】：

你要等多久？
@zabop 我的情况，2 分钟。
我等了 30 多分钟，什么也没发生。不过第二天就成功了。
我花了大约一个小时。我想知道他们是否也忘记为默认分支修复此问题，该分支现在是“主”而不是“主”。（他们的文档仍然告诉你推送到 master，尽管默认创建了 'main'）
我的案例是 cca 5 分钟。他们应该添加一条警告，说明这可能需要一些时间。

【解决方案2】：

推送第二次提交为我解决了这个问题。

看到其他答案可以解决此问题，我猜您需要触发一些部署才能使其正常工作。

每次推送都会触发新的部署。您可以在 https://github.com/username/username.github.io/deployments 跟踪部署。

【讨论】：

再次推送对我有用。似乎某些缓存有问题
推送另一个提交也为我修复了它。如果它是一个缓存，它必须是 github 端的东西，因为即使硬刷新应该清除缓存（Shift+ctrl+R），没有index.html 的页面对我来说仍然是 404。
这在 2021 年仍然是一个问题，以防有人想知道。如果您推送一个删除 index.html 的提交，然后推送另一个提交以将其放回，也会发生这种情况。
我刚刚重新运行了我的构建工作流程，它得到了修复。
这里也一样！推动第二次提交修复了它。谢谢！

【解决方案3】：

如果你不使用 Jekyll，解决方法是在根目录下放置一个名为 .nojekyll 的文件。

【讨论】：

我正在使用 Hugo 生成我的网站，这对我有用！谢谢

【解决方案4】：

我的 index.html 有以下 DOCTYPE 设置：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" http://www.w3.org/TR/html4/strict.dtd">

改成：

<!DOCTYPE html>

为我解决了这个问题。

【讨论】：

我的index.html 没有指定DOCTYPE，这为我解决了问题。
我错了<!doctype html>。将其更改为 <!DOCTYPE html> 解决了我的问题。

【解决方案5】：

我今天（2020 年 5 月 28 日）也遇到了同样的问题。假设您已正确完成所有操作（https://pages.github.com/ 中的说明），您应该设置了一个名为 username.github.io 和 index.html 的存储库。

对我有用的是我选择了 Jekyll 主题。首先，转到回购的Settings。在GitHub Pages 部分，查找Theme Chooser，然后单击Choose a Theme。它会将您重定向到一个 GitHub 页面，该页面有多个可供您选择的主题。选择您喜欢的主题，然后单击Select Theme。完成这些步骤后，我刷新了我的username.github.io 并且页面正常工作。

【讨论】：

这是原因之一，如果不选择主题，它将不允许使用 username.github.io 访问

【解决方案6】：

今天面临这个问题（2019 年 10 月 6 日）

我仔细检查了每个设置，所有这些设置都没有为我解决问题，除非我更改了 index.html 文件中的一些内容。我还在 repo 中添加了一些文件以使其“活着”但徒劳无功。

所以，在我的例子中，我在浏览器中打开了我的 index.html，点击编辑并添加了一个单词，提交到 master 分支，刷新了不到 5 秒，它又恢复了。

附注我尝试了几乎所有的解决方案，没有其他任何对我有用的地方。

【讨论】：

谢谢。在我的情况下，我在 index.html 中添加了一个额外的空行，保存，提交然后推送..一切都很好。
对我来说也一样，只是在顶部删除了一个空行，它起作用了！谢谢！

【解决方案7】：

我遇到了同样的问题。如果您在发布所有代码一小时后尝试在指定的 repo > Settings > GitHub Pages 中找到的链接，GitHub 页面将正常工作。

【讨论】：

【解决方案8】：

这发生在我身上，一旦我再次提交，问题就会自行解决。我刚刚在 dist 文件夹中的 index.html 文件中添加了一个空格，提交并将该更改推送到我的 gh-pages 分支和 BAM！现在我可以通过访问 username.github.io/repository/index.html 来访问 username.github.io/repository。

【讨论】：

【解决方案9】：

类似的问题。我必须对我的 html 进行随机更改，通过 git add/commit/push 过程。那为我修好了！现在我可以访问我的页面，而无需在 url 末尾添加 .html。

【讨论】：

【解决方案10】：

如果您不使用 Jekyll，请从存储库中删除 _config.yml 文件。这解决了我的问题。

您也可以尝试再次推送本地存储库。

【讨论】：

这对我有用。谢谢！

【解决方案11】：

参加聚会已经很晚了，但这是我今天为自己解决的方法。

转到存储库的设置：您可以在存储库页面中找到“设置”选项卡。
向下滚动到设置页面上的 GitHub Pages 部分。
在面板中，您将有一个 Source 信息，其中指出：“您的 GitHub Pages 站点当前正在从 gh-pages 分支构建'。
但是，在我的情况下，所有代码都在 master 分支中。所以我从下拉列表中选择了这个分支作为master，仅仅一分钟，它就发布成功了。

【讨论】：

虽然这不是我的问题，但我可以想象很多人会对此措手不及。

【解决方案12】：

我在私有存储库中遇到了类似的问题。我的 Git 项目在根目录中包含 index.html，但该页面未显示在 http(s)://<username>.github.io/<projectname> 路径下。

任何一种方式（公共存储库与否）的解决方案是在“GitHub 页面”下的项目存储库设置中启用 GitHub 页面。

但是，请注意，启用私有存储库下的页面会使 .html 文件公开。

【讨论】：

【解决方案13】：

我在使用Github Actions 从gh-pages 分支自动部署bookdown 页面时遇到了同样的问题：

当我尝试在存储库设置的 GitHub Pages 部分访问 Github 建议的 url https://<username>.github.io/<reponame>/

我收到 Error404: Page not found 响应。

但是，在网址末尾手动添加“index.html”会显示该页面。 https://<username>.github.io/<reponame>/index.html

手动将具有以下内容的 CNAME 文件添加到 gh-pages 分支永久解决了该问题：

 https://<username>.github.io/<reponame>/index.html

不过，这更像是一种解决方法......

编辑：

添加CMAKE 文件只是暂时解决了问题，因为它在调用 gh 操作工作流时被删除。要么：

i) 更改 gh-actions 工作流程以在最后创建 CMAKE 文件（仍然是一种解决方法...）

或者我如何在使用bookdown的特定情况下解决它：

ii) 在 index.Rmd 文件的 YAML 头中，我添加了

url: "https://<username>.github.io/<reponame>/"

【讨论】：

【解决方案14】：

还有一个更微妙的问题导致了这个问题。如果您在 index.html 中使用大尺寸的图像文件，则会出现此问题。减小正在加载的图像的大小为我解决了这个问题。

【讨论】：

【解决方案15】：

在“设置”>“Github 页面”中，确保在那里选择的分支与您正在使用的分支相同。我遇到了同样的问题，分支是 master 而不是 main，所以我更改了它，现在已修复。

【讨论】：