React网站无法在GitHub Pages部署问题求助

核心配置检查 #

• 确认package.json中是否添加正确的homepage字段，格式应为："homepage": "https://AfeefRaza.github.io/ecom-website"
• 检查scripts字段是否包含部署相关命令：

  "scripts": {
    // ...其他脚本
    "predeploy": "npm run build",
    "deploy": "gh-pages -d build"
  }
  

  若没有，先安装依赖：npm install gh-pages --save-dev，再添加上述脚本

重新部署操作 #

1. 执行npm run build，查看生成的build文件夹，确认里面是你的自定义网站内容而非初始页面
2. 运行npm run deploy完成部署推送
3. 进入GitHub仓库的「Settings -> Pages」页面，确认部署源选择的是gh-pages分支的/root目录，保存设置

缓存与内容更新 #

• 部署完成后，用Ctrl+F5强制刷新浏览器，清除缓存
• 等待5-10分钟，GitHub Pages可能需要时间同步最新部署内容

仓库代码验证 #

• 确认本地所有自定义页面代码已推送到GitHub仓库的主分支，无遗漏
• 检查public/index.html中的资源路径，避免使用绝对路径，改用相对路径或依赖homepage配置的路径

内容的提问来源于stack exchange，提问作者Afeef Raza