GitHub Pages仅显示README页面且无法选择源的解决方法咨询

• 检查仓库分支结构
  确保仓库有至少一个可用于Pages部署的分支（比如main或gh-pages），如果没有分支，先在本地创建main分支并推送到远程仓库。进入仓库「Code」标签确认分支存在，若分支丢失，通过本地Git命令恢复或新建。

• 确认仓库入口文件配置
  你的仓库是<username>.github.io类型，这类仓库默认从main分支的根目录部署。如果根目录没有index.html、index.md这类入口文件，GitHub会自动展示README.md。检查仓库根目录，添加或修改入口文件即可替换默认的README展示。

• 修复Pages设置的源选项

  1. 检查仓库权限：进入仓库「Settings」→「Actions」→「General」，确认「Workflow permissions」设置为「Read and write permissions」，保存后刷新Pages设置页面。
  2. 清除浏览器缓存或用无痕模式打开Pages设置页，排除前端缓存导致的选项不显示问题。
  3. 推送一个新提交到main分支，触发GitHub仓库状态更新，之后再回到Pages设置页查看源选项是否出现。

• 手动部署Pages（可选）
  如果上述步骤无效，可手动创建部署工作流：在仓库根目录新建.github/workflows/pages.yml文件，填入以下内容：

  name: Deploy GitHub Pages
  on:
    push:
      branches: [ main ]
    workflow_dispatch:
  jobs:
    deploy:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v4
        - name: Deploy to GitHub Pages
          uses: peaceiris/actions-gh-pages@v4
          with:
            github_token: ${{ secrets.GITHUB_TOKEN }}
            publish_dir: ./
  

  提交并推送该文件后，GitHub会自动运行部署工作流，完成后回到Pages设置页即可选择源。

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