You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

GitHub Pages站点相对链接跳转404错误该如何排查修复?

GitHub Pages 404错误修复方案
  • 检查链接路径格式:你的站点部署在仓库子路径/odin-recipes/下,如果跳转链接写的是根绝对路径(比如/lasagna.html),GitHub Pages会从站点根目录https://furqaan78621.github.io/下查找文件,找不到就报404。把所有跳转链接改成相对路径即可,比如指向千层面食谱的链接改为./recipes/lasagna.html(根据你实际的文件层级调整),不要在路径开头加/。
  • 检查文件名大小写:GitHub Pages 对文件名大小写敏感,而Windows、macOS本地环境默认大小写不敏感。比如本地文件名为Lasagna.html,但链接写的是lasagna.html,本地可以正常跳转,线上就会404,保证链接填写的文件名和实际文件的大小写完全一致即可。
  • 检查文件部署状态:进入你的代码仓库,确认千层面的食谱文件已经推送到了GitHub Pages设置的部署分支(一般为main或者gh-pages分支),且存放在代码中链接指向的对应目录下,避免漏推送、放错目录的问题。
个人项目存储空间搭建方案
  • 后续开发的每个独立项目单独创建GitHub仓库,每个仓库都可以单独开启GitHub Pages功能,项目的默认访问地址为https://你的用户名.github.io/对应仓库名/,项目之间互不干扰,管理成本很低。
  • 可以额外创建一个命名为你的用户名.github.io的专属仓库,这个仓库开启GitHub Pages后,访问地址就是你的个人主页根地址,你可以在这个仓库的首页做导航菜单,把所有已完成项目的Pages地址都汇总进去,后续新增项目只要更新导航即可。
  • 所有项目开发时统一使用相对路径做内部跳转,避免后续部署时重复出现路径错误。

内容的提问来源于stack exchange,提问作者Fkhadim123

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 14:15:04