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

GitHub托管网页后无法访问 仅显示README同名链接不跳转

GitHub Pages 托管后仅显示README链接、无法加载网页的解决方案

该问题由GitHub Pages未识别到合法站点入口、触发默认README渲染逻辑导致,按以下步骤排查修复:

  • 修正首页文件命名
    GitHub Pages默认仅识别部署目录下名为index.html的文件作为站点首页。若首页文件使用其他命名(如和README同名的自定义名称、home.html、page.html等),服务找不到入口就会直接渲染README内容,其中的链接不会被识别为站点路由,点击无响应。将首页文件重命名为index.html,放置到对应部署目录下即可。
  • 核对部署路径配置
    进入仓库Settings > Pages配置页,确认Source项选中的分支、部署目录和网页文件实际存放位置完全匹配:
    • 网页文件直接存放在分支根目录时,目录选项选择/(root)
    • 网页文件存放在docs文件夹时,目录选项选择/docs
      路径配置错误会导致服务无法定位网页文件,直接 fallback 到README渲染逻辑。
  • 校验路径大小写匹配
    GitHub Pages托管服务对文件名大小写敏感,代码内的链接、资源引用路径大小写如果和实际文件不一致,会出现点击无响应、资源加载失败问题。所有文件名、路径引用建议统一使用小写,和实际文件完全对齐。
  • 清缓存等待部署生效
    每次提交代码、修改配置后,GitHub Pages需要1~5分钟完成部署,直接到仓库Actions页面查看Pages部署workflow是否运行完成。部署完成后按Ctrl+F5强制刷新浏览器清除缓存再访问,不要直接访问旧缓存页面链接。

注意:不要给index.html添加特殊前缀、后缀,否则服务无法识别为站点入口。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.31 00:33:19