求助:GitHub Pages仅显示README文件,无法正常托管网页
GitHub Pages仅显示README的解决方法
针对你的仓库tomertal3/asafwle和对应GitHub Pages站点tomertal3.github.io/asafwle/仅显示README的问题,按以下步骤排查解决:
- 检查Pages发布源配置:进入仓库Settings页面的Pages板块,确认发布分支与目录是否匹配你的网页文件位置。如果网页主文件(如index.html)在根目录,需选择对应分支的
/(root)目录;若在docs文件夹,则选/docs目录。 - 确认首页文件存在:GitHub Pages优先加载根目录下的
index.html,若该文件缺失才会默认显示README.md。检查仓库中是否存在index.html,且放置在正确的发布目录下。 - 核对发布分支:确保选择的发布分支是包含完整网页文件的分支(比如main或master),而非其他分支。
- 等待部署刷新:修改配置后,GitHub Pages需要1-5分钟完成重新部署,之后刷新站点页面查看效果。
- 强制清理浏览器缓存:使用
Ctrl+F5(Windows)或Cmd+Shift+R(Mac)强制刷新页面,避免缓存的README内容干扰显示。
内容的提问来源于stack exchange,提问作者tomertal
相关产品推荐
相关产品推荐

