GitHub Pages无法加载HTML文件，仅显示README文件求助

• 检查 GitHub Pages 发布源配置
  进入仓库的 Settings → Pages，确认发布分支和目录是否匹配你的 HTML 文件位置。如果 HTML 在根目录，要选对应分支的 /root；如果在 docs 文件夹就选 /docs。另外部分主题或静态站点配置会强制把 README.md 设为首页，得确认有没有这类规则。

• 确保 HTML 文件名为 index.html
  GitHub Pages 默认优先加载根目录下的 index.html 作为首页，要是你的 HTML 文件叫别的名字（比如 main.html），页面就会默认加载 README.md。把文件名改成 index.html 就能让它成为首页。

• 排查 Actions 工作流的发布逻辑
  打开 .github/workflows/ 下的配置文件，检查是否有步骤正确复制 HTML 文件到发布目录。比如有些工作流可能只处理 README 或静态生成文件，漏掉了你的 HTML。可以添加明确的复制步骤：

  - name: 复制 HTML 文件到发布目录
    run: cp your-file.html ./docs/index.html  # 根据实际路径调整
  

  同时查看 Actions 日志，确认 HTML 文件确实被上传到发布 artifacts 里，没被过滤或忽略。

• 清除 GitHub Pages 缓存并重新部署
  缓存可能导致页面不更新，你可以在仓库 Settings → Pages 页面点击 Deploy branch 手动重新发布，或者修改 README.md 提交一次，触发 Actions 重新运行。

• 检查 .gitignore 规则
  确认你的 HTML 文件没被 .gitignore 排除，导致没推送到仓库。如果有相关排除规则，删掉对应行或者调整规则包含你的 HTML 文件。

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