使用Jekyll主题部署GitHub Pages时显示index.html原始文本求助

• 检查GitHub Pages源设置
  进入仓库Settings > Pages，确认“Source”选择的是gh-pages分支的/root目录。如果误选了main分支，GitHub会直接展示源码文件，而非编译后的静态页面。

• 验证GitHub Actions执行状态
  打开仓库的Actions页面，查看最近的工作流运行记录。如果工作流失败或有报错，点击日志详情，搜索error关键词定位问题——比如依赖安装失败、构建命令执行错误都会导致静态文件未生成。

• 本地构建结果校验
  在本地执行bundle exec jekyll build，检查_site目录下的index.html是否是包含主题样式和布局的完整页面。如果本地_site内容正确，但GitHub上gh-pages分支的index.html仍是源码，说明Action的构建或部署步骤存在问题。

• 核对工作流配置文件
  对比Chirpy主题官方的pages-deploy.yml，确认你的配置：

  • 依赖拉取步骤（如actions/checkout、ruby/setup-ruby）的版本是否符合主题要求；
  • 构建命令bundle exec jekyll build是否正确执行；
  • 部署步骤是否指定了正确的发布目录，比如peaceiris/actions-gh-pages需配置publish_dir: ./_site。

• 检查gh-pages分支内容
  直接查看仓库的gh-pages分支，确认分支内是编译后的静态资源（包含css、js等目录，index.html为完整页面代码）。如果该分支内容与main分支一致，说明Action未完成构建推送流程。

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