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

React应用部署GitHub Pages终端显示发布成功但站点构建报错

React应用部署GitHub Pages构建失败解决方案
  • 新增.nojekyll文件禁用Jekyll构建
    GitHub Pages默认使用Jekyll引擎处理静态资源,会自动忽略所有下划线开头的文件/文件夹,而React打包生成的build目录下包含_static这类下划线开头的资源,是触发本次构建报错的核心原因。你只需要在项目的public文件夹下新建一个名为.nojekyll的空文件,重新执行npm run deploy部署即可,这个文件会通知GitHub Pages跳过Jekyll构建流程,直接使用你上传的静态文件。
  • 确认仓库Pages配置正确
    进入你的GitHub仓库设置页,找到Pages选项,确认部署源选择的是gh-pages分支的/root目录,配置修改后等待3-5分钟刷新站点即可。
  • 核对homepage字段与仓库信息匹配
    你package.json中配置的homepage地址为https://srijit2002.github.io/todoapp,需要确认你的GitHub仓库名确实为todoapp,如果仓库名不一致需要修改homepage字段对应的值,再重新执行部署。
  • 升级gh-pages依赖版本
    旧版本的gh-pages包可能存在兼容性问题,可以运行命令npm install gh-pages@latest --save-dev升级到最新版本后重新执行部署操作。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.21 00:24:03