为何我的Jekyll页面显示原始Front Matter？求助排查

以下是针对你遇到的页面显示---- layout: home # Index page ----问题的排查步骤：

• 修正Front Matter分隔符格式
  Jekyll识别的YAML头必须用三个连字符---包裹，而非四个。检查你首页文件（如index.md）的开头，确保是：

  ---
  layout: home # Index page
  ---
  

• 验证GitHub Pages构建配置

  • 进入仓库的「Settings」→「Pages」页面，确认部署分支正确，「Build and deployment」的「Source」选择了对应分支和根目录，且Jekyll构建处于启用状态。
  • 检查仓库根目录的_config.yml，确认包含theme: jekyll-theme-chirpy（或正确的远程主题配置remote_theme: cotes2020/jekyll-theme-chirpy），且配置无语法错误。

• 检查文件编码与换行符
  用文本编辑器打开首页文件，确保文件编码为UTF-8，换行符使用LF格式，格式错误可能导致Jekyll无法解析Front Matter。

• 本地构建测试
  本地安装Jekyll依赖后，克隆仓库执行以下命令测试：

  bundle install
  bundle exec jekyll serve
  

  若本地显示正常，说明是GitHub Pages构建缓存问题，可提交空改动（如修改README.md后恢复）触发重新构建。

• 确认模板使用流程
  Chirpy模板需通过仓库的「Use this template」按钮创建新仓库，手动复制文件可能遗漏_layouts、_includes等关键目录，导致Jekyll无法识别主题布局。

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