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

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.01 17:30:41