GitHub新手求助:username.github.io无法访问问题排查
排查 username.github.io 无法访问的核心步骤
- 严格匹配仓库命名:仓库名称必须是
username.github.io(username是你的GitHub用户名,大小写完全一致,不能有拼写错误),且必须设为公开仓库。如果你的4个仓库里没有符合这个命名的,肯定无法访问。 - 确认分支与部署路径:进入目标仓库的「Settings」→「Pages」,检查「Source」选项:分支要选你推送代码的那个(现在主流是
main分支),路径要选「/(root)」(除非你特意把页面文件放在docs文件夹里)。 - 检查文件位置:你的
index.html必须放在仓库根目录,不能嵌套在子文件夹里。CSS、JS等资源要用相对路径引用,比如<link rel="stylesheet" href="style.css">,避免用绝对路径导致加载失败。 - 等待部署完成:首次推送代码后,GitHub Pages部署需要几分钟时间,不是实时生效的。可以去仓库的「Actions」页面查看部署任务状态,等任务完成后再访问。
- 确认仓库可见性:确保仓库是公开的,私有仓库开启Pages需要付费权限,新手用公开仓库更稳妥。
- 强制刷新浏览器:有时候浏览器会缓存旧的404页面,按
Ctrl+Shift+R(Windows)或Cmd+Shift+R(Mac)强制刷新后再试。
内容的提问来源于stack exchange,提问作者Bruna G
相关产品推荐
相关产品推荐

