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

访问GitHub Pages站点myname_examp.github.io出现404错误如何解决

GitHub Pages 404错误排查步骤
  • 核对仓库命名规则
    仓库名必须和你的GitHub用户名完全匹配,格式为你的用户名.github.io,不能出现错拼、多字符、少字符的问题,大小写需和用户名保持一致。
  • 确认仓库可见性
    免费GitHub账号仅支持公开仓库开启Pages服务,检查仓库是否被设置为私有,私有仓库部署的Pages会返回404。
  • 检查Pages部署配置
    进入仓库的「Settings」→「Pages」页,查看Source区域的配置:
    • 部署分支是否和你提交代码的分支一致(比如你代码提交到了main分支,这里就需要选择main)
    • 部署目录是否和文件存放位置匹配:如果入口文件存放在根目录就选/root,存放在docs文件夹就选/docs
  • 检查入口文件是否存在
    确保你配置的部署目录下存在命名为index.html的入口文件,文件名需为全小写,大写命名的Index.html或INDEX.HTML会因大小写敏感无法识别。
  • 确认代码已成功推送至远程
    进入GitHub仓库对应部署分支的文件列表,检查你的HTML、CSS等网站文件是否已经成功上传,排除本地提交后未push到远程的问题。
  • 等待部署完成
    GitHub Pages部署不是实时生效的,提交代码后通常需要1~10分钟的部署时间,你可以进入仓库的「Actions」标签页,查看对应部署任务的运行状态,确认是否存在部署失败的情况。
  • 清理浏览器缓存重试
    可使用Ctrl+F5强制刷新页面,或者开启浏览器无痕模式访问地址,排除本地缓存的旧404页面影响。
  • 检查CNAME文件(如有配置自定义域名)
    如果仓库根目录下存在CNAME文件,确认文件内填写的域名是否和你访问的域名匹配,误生成的CNAME文件会导致默认的github.io域名无法正常访问。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.25 07:24:01