React App构建异常：公网显示README而非应用（GitHub Pages部署）

• 检查GitHub Pages部署源设置：
  进入仓库Settings → Pages页面，确认部署分支选择了包含build文件的分支（比如main分支），同时文件夹路径要选/build——如果默认选根目录，GitHub会优先加载README.md而非build里的index.html。

• 用gh-pages分支规范部署（如果没这么做的话）：

  1. 安装依赖：npm install gh-pages --save-dev
  2. 在package.json里添加部署脚本：

     "scripts": {
       "predeploy": "npm run build",
       "deploy": "gh-pages -d build"
     }
     

  3. 执行npm run deploy，之后回到Pages设置，把部署分支改成gh-pages。

• 校验自定义域名配置：
  在Pages设置里确认自定义域名hudsonbasso.com已正确填写，同时DNS解析要添加CNAME记录指向你的<用户名>.github.io。如果仓库根目录有CNAME文件，确保内容就是hudsonbasso.com，无多余字符。

• 触发重新部署清缓存：
  缓存可能导致页面不更新，可以在Pages设置里重新保存一次部署源，或者提交一个微小改动（比如修改README的空格）触发仓库重新构建。

• 确认build产物完整性：
  检查仓库里的build文件夹，确保包含index.html、static等完整构建文件，且build过程无报错、产物已正确推送到仓库。

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