Github Pages无法显示全部HTML文件，高分页提示404该如何解决？

排查步骤 #

• 检查文件名大小写匹配：GitHub Pages 服务对路径大小写敏感，需确认仓库中高分页面的实际文件名，与其他页面跳转时引用的路径大小写完全一致，比如本地测试时不区分大小写的系统（Windows、macOS）不会报错，但部署到Linux环境的GitHub Pages就会触发404。
• 检查跳转路径格式：你的项目部署在/familyguy-trivia/子路径下，如果跳转链接写为绝对路径/highscores.html，会指向根域名下的地址https://tgriff21.github.io/highscores.html而非项目子路径下的正确地址，需确认所有跳转用的是相对路径如./highscores.html。
• 检查文件提交状态：确认高分页面对应的HTML文件已经成功提交并推送到了GitHub仓库中设置的Pages部署分支（默认是main分支的根目录），同时确认该文件没有被.gitignore规则过滤。
• 检查部署状态：进入仓库的Settings → Pages页面，确认最近一次部署任务执行成功，没有报错提示，部署失败时新提交的页面不会生效。

解决方法 #

• 大小写问题：统一所有HTML文件名和跳转引用路径的大小写，推荐全部使用小写命名避免后续出现同类问题，修改后重新提交推送即可。
• 路径错误问题：将所有站内跳转的绝对路径开头的/改为相对路径的./，或者跳转路径前加上项目子路径，示例：href="/highscores.html"改为href="./highscores.html"。
• 部署异常问题：如果部署记录提示失败，根据报错提示修正对应问题后重新推送代码触发部署即可。

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