React项目部署GitHub Pages后显示站点未找到问题求助

从你的构建输出能看到关键提示：The project was built assuming it is hosted at /react-gh-pages.github.io/.，问题大概率出在package.json的homepage配置或GitHub Pages设置上，按以下步骤修复：

• 修正package.json的homepage字段
  打开项目根目录的package.json，把homepage改成你GitHub Pages的实际地址：

  • 如果仓库名是react-gh-pages，格式为：

    "homepage": "https://你的GitHub用户名.github.io/react-gh-pages/"
    

  • 如果是个人主页仓库（仓库名是你的用户名.github.io），格式为：

    "homepage": "https://你的GitHub用户名.github.io/"
    

• 重新构建部署
  重新执行构建和部署命令：

  npm run build
  npm run deploy
  

• 检查GitHub Pages分支设置
  进入GitHub仓库的「Settings」→「Pages」页面：

  • 确认「Source」选择的分支是gh-pages（gh-pages工具默认将构建内容推送到该分支）
  • 确认根目录选择/(root)而非其他路径

• 等待生效
  GitHub Pages部署后可能需要1-5分钟才会生效，耐心等待后刷新页面重试

另外，确保gh-pages包已正确安装，未安装的话先执行：

npm install gh-pages --save-dev

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