GitHub Pages新上传的Index.html显示404，寻求配置及解决办法

核心结论 #

_config.yml不是必填项，但如果启用了Jekyll主题或构建流程，配置错误会导致静态文件无法正常发布。你遇到的404问题大概率和Jekyll构建逻辑或仓库设置有关，下面是具体解决步骤：

1. 快速恢复2017年的静态托管模式（最直接） #

如果不需要Jekyll的主题、模板功能，只想像以前一样直接托管HTML/JS文件，只需在仓库根目录添加一个空的.nojekyll文件。这个文件会告诉GitHub Pages跳过Jekyll构建流程，直接把你的静态文件原样发布，和你2017年的项目逻辑完全一致。

操作方式：

• 在本地仓库根目录创建名为.nojekyll的空文件（注意文件名开头的点）
• 提交并推送到GitHub仓库
• 等待5-10分钟后重新访问页面即可

2. 如果要保留Jekyll，修正你的_config.yml配置 #

你当前的_config.yml存在配置错误，导致Jekyll构建异常：

• permalink字段不能设置为完整URL，应使用相对路径格式，比如permalink: /:path/或默认的日期格式
• 根域名仓库（renovatio4ever.github.io）无需设置name字段，正确的基础配置示例：

url: https://renovatio4ever.github.io
baseurl: "" # 根项目留空，子项目如FutureGame需设为"/FutureGame"
theme: jekyll-theme-minimum
title: sad new site
description: a necessary bookmark

• 确保_config.yml文件放在仓库根目录，文件名拼写正确（是_config.yml，不是config.yml）

3. 检查仓库Pages设置 #

进入仓库的「Settings」→「Pages」页面，确认：

• 「Source」选择的分支正确（比如main分支）
• 「Folder」选择的是「/(root)」（根项目）或「/FutureGame」（子项目）
• 查看页面下方的「Build and deployment」日志，确认是否有构建错误（比如Jekyll编译失败）

4. 验证文件路径和大小写 #

• 确认index.html确实在仓库的根目录和FutureGame文件夹下，没有被误放到其他子目录
• GitHub文件名区分大小写，确保文件名是index.html（全小写，不要写成Index.html或INDEX.HTML）

内容的提问来源于stack exchange，提问作者NanoNet