如何解决GitHub Pages仅展示README页面的问题？

仓库地址：kalrasarthak/ReFash
GitHub Pages页面：kalrasarthak.github.io/ReFash/

以下是针对性的排查和解决步骤：

• 检查Pages源配置：进入仓库的「Settings」→「Pages」页面，确认部署源的分支和目录是否正确。比如是否选择了项目的主分支（如main）对应的根目录（/root）或docs文件夹，而非错误地指向仅包含README的路径。
• 确认入口文件存在：确保项目根目录（或指定的部署目录）下有index.html（静态站点）或index.md（Jekyll站点）作为首页入口。如果是需要打包的项目（如React/Vue），要确认打包后的产物（通常是dist文件夹）已推送到指定分支，且Pages配置指向该分支的dist目录。
• 排查Jekyll配置（若使用）：如果仓库使用Jekyll生成站点，检查_config.yml中的配置：
  • 确认permalink设置未强制将首页导向README
  • 检查exclude/include规则，确保首页入口文件未被排除
• 触发重新部署：在Pages设置页面点击「Deploy branch」按钮手动触发重新部署，或提交一次微小的代码变更（比如修改README的空格），触发GitHub自动重新构建站点，清除可能存在的缓存问题。
• 检查文件与分支权限：确认部署分支为公开状态，且首页入口文件未被.gitignore规则排除，打包产物目录（如dist）未被忽略。
• 查看部署日志：如果使用GitHub Actions部署，进入仓库的「Actions」页面查看最近的部署日志，排查是否存在构建失败、文件缺失等报错信息，定位具体问题。

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