Jekyll博客标签与分类列表页面无法加载问题求助

基于al-folio模板搭建的Jekyll博客，文章可正常显示，但标签、分类列表页面（如/blog/tag/formatting）无法加载，怀疑问题出在_layout目录下的archive-tag.html、archive-category.html和archive-year.html文件的加载逻辑上。

• 检查配置文件的页面生成规则
  打开_config.yml，确认是否开启了文章集合的输出配置，同时验证标签/分类的 permalink 规则是否匹配预期路径：

  collections:
    posts:
      output: true
  
  # 检查是否存在类似的标签页面路径配置
  permalink: /blog/:year/:month/:day/:title/
  tag_permalink_style: pretty
  tag_page_dir: blog/tag
  

• 验证布局文件的Front Matter
  查看archive-tag.html、archive-category.html、archive-year.html的文件头部，确认Front Matter语法正确且引用了存在的父布局：

  ---
  layout: default
  ---
  

  若存在语法错误或引用了不存在的布局，会直接导致页面加载失败。

• 检查布局文件的数据调用逻辑
  在存档布局文件中，确认筛选对应标签/分类文章的代码是否正确。例如archive-tag.html中应包含类似逻辑：

  {% assign posts = site.tags[page.tag] %}
  {% for post in posts %}
    <!-- 文章列表渲染代码 -->
  {% endfor %}
  

  排查变量名是否拼写错误，或循环逻辑是否被误修改。

• 本地构建查看错误日志
  在本地执行bundle exec jekyll build命令，查看终端输出的构建日志，重点关注布局文件相关的报错（如变量未定义、文件不存在等），日志会直接定位问题根源。

• 对比原版模板文件
  将自己博客中的三个存档布局文件与al-folio原版模板的对应文件逐行对比，排查是否因自定义修改导致逻辑断裂，比如误删了文章筛选的核心代码块。

• 检查文章的标签/分类格式
  确认博客文章的Front Matter中标签、分类的格式是否符合要求：

  ---
  tags: [formatting, jekyll]
  categories: [技术笔记]
  ---
  

  格式错误会导致文章无法被正确关联到对应的标签/分类列表页面。

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