使用yarn deploy部署后，gh-pages显示README而非分支内容的问题求助

1. 核对GitHub Pages部署源设置 #

• 进入仓库设置的「Pages」选项卡
• 确认部署源选择GitHub Actions（框架类项目需构建后部署，不建议直接选分支）；若选分支，需指定gh-pages分支，且部署目录设为/build（或构建产物所在目录）

2. 验证本地构建流程 #

• 本地执行npm run build（或yarn build），检查是否生成build（或对应框架的产物目录，如dist），目录内必须包含index.html及完整静态资源
• 检查package.json的homepage字段，需配置为你的自定义域名：

  "homepage": "https://hudsonbasso.com"
  

3. 检查GitHub Actions部署脚本 #

• 查看仓库.github/workflows下的部署配置文件（如deploy.yml），确保包含构建与产物上传步骤：

  - name: 安装依赖并构建
    run: npm install && npm run build
  - name: 部署到GitHub Pages
    uses: peaceiris/actions-gh-pages@v3
    with:
      github_token: ${{ secrets.GITHUB_TOKEN }}
      publish_dir: ./build
  

  重点确认publish_dir指向正确的构建产物目录

4. 检查gh-pages分支内容 #

• 切换到gh-pages分支，确认根目录下是构建后的index.html和静态资源，而非仅README.md。若缺少构建产物，说明构建或部署步骤未正确执行

5. 自定义域名配置检查 #

• 在仓库Pages设置中确认已添加自定义域名hudsonbasso.com，且DNS解析的CNAME记录指向hbasso.github.io
• 确认域名已通过GitHub的SSL证书验证，避免证书问题导致页面异常

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