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
相关产品推荐
相关产品推荐

