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

发布GitHub Pages站点时出现404错误该如何解决?

GitHub Pages 404错误排查步骤
  • 检查Pages部署源配置
    进入对应仓库的Settings页,找到左侧菜单栏的Pages选项,确认Source配置:
    • 分支是否选择正确(大部分场景默认用main或master分支,用gh-pages分支部署的场景要对应选择gh-pages)
    • 部署目录是否选择正确,纯静态站点直接放根目录的选/ (root),有打包输出目录的(如dist、public)要对应选择对应目录
  • 检查站点入口文件
    确认你选择的部署目录下存在index.html文件,GitHub Pages默认将该文件作为站点首页,注意文件名大小写完全匹配,若为Index.html、INDEX.html都无法被正常识别
  • 检查部署任务状态
    进入仓库的Actions标签页,查看最近的Pages部署工作流运行状态,若显示运行失败,点击对应任务查看报错详情修复即可
  • 检查仓库命名规则
    确认你的仓库名完全匹配你的GitHub用户名.github.io格式,大小写、字符完全对应,不能有多余字符或拼写错误
  • 等待部署延迟或清除缓存
    GitHub Pages部署存在最长10分钟的延迟,刚完成部署操作可以稍等几分钟后,用强制刷新(Windows按Ctrl+F5、Mac按Cmd+Shift+R)访问站点即可

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.03 04:09:01