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

