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

Github Pages根路径404,/index可加载index.html问题求助

GitHub Pages根路径404但/index能加载?问题出在这!

嘿,我仔细梳理了你的情况,这问题其实挺常见的,根源就在文件命名和GitHub Pages的默认索引规则不匹配上。

先给你拆解下逻辑:当你访问域名根路径时,GitHub Pages服务器会自动去寻找预设的索引文件,它的优先级顺序里,index.html是排在最前面的——也就是说,服务器默认认为根路径的主页应该是index.html。但你的仓库里,主页文件是不带.html后缀的index,服务器在根路径请求时找不到它要的index.html,自然就返回404了。

那为什么访问/index就正常呢?因为这时候你直接指定了文件名,服务器会精准匹配到那个叫index的文件,而且文件内容本身是HTML格式,浏览器拿到后会自动解析渲染,所以就能正常显示主页了。

解决起来也很简单,给你两个方案选:

  • 最直接的:把仓库里的index文件重命名为index.html,这样根路径请求时服务器就能自动识别它作为默认主页,404问题直接解决。
  • 要是不想改文件名,可以在仓库根目录加个_config.yml文件,配置自定义的索引规则,但说实话第一种方法更省心,完全符合GitHub Pages的默认逻辑。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.15 03:28:30