使用Travis CI部署GitHub Pages时jekyll-archives无法生成归档页

核心问题分析 #

本地运行jekyll-archives正常，但Travis部署后无归档页面，而同属第三方插件的jekyll-paginate-v2正常工作，说明问题大概率出在Travis构建环境与本地的差异或插件配置的细节遗漏上。

排查与解决步骤 #

1. 检查Travis构建日志的报错信息 #

登录Travis CI控制台，找到对应项目的构建记录，查看完整输出日志，搜索jekyll-archives相关内容：

• 若提示找不到archive布局，确认项目根目录下_layouts/archive.html文件存在，且内容正确引用了归档变量（如page.posts）
• 若提示插件加载失败，说明依赖版本不兼容，需锁定插件版本

2. 锁定jekyll-archives的版本 #

本地环境的插件版本可能与Travis自动安装的版本不一致，导致行为差异：

• 先在本地运行gem list jekyll-archives查看当前使用的版本，然后在Gemfile中指定该版本：

gem 'jekyll-archives', '2.2.1' # 替换为你本地的版本号

• 运行bundle install更新Gemfile.lock，提交这两个文件到仓库，确保Travis安装相同版本

3. 校验_config.yml的归档配置细节 #

确认配置无拼写或逻辑错误：

• 检查jekyll-archives.enabled列表是否正确（categories、tags不要拼错）
• 确认layout: archive对应的布局文件存在，且路径正确
• 验证permalink格式无冲突（比如/category/:name/不要和其他页面路径重复）

4. 确保Travis构建命令未禁用插件 #

当前.travis.yml中的script: bundle exec jekyll build是正确的，不要添加--safe参数（该参数会禁用所有第三方插件）

5. 本地模拟Travis构建流程验证 #

在本地执行bundle exec jekyll build，检查_site目录下是否生成category/和tag/文件夹：

• 若本地生成正常，检查Travis的部署配置：确认local_dir: _site指向正确，skip_cleanup: true未被覆盖（避免部署前清理构建产物）

示例修正后的配置 #

Gemfile（锁定插件版本） #

source 'https://rubygems.org'
gem 'jekyll', '<4'
gem 'html-proofer', '4.3.1'
gem 'jekyll-archives', '2.2.1'
gem 'jekyll-sitemap'
gem 'jekyll-paginate-v2'
gem 'kramdown-parser-gfm'
gem 'webrick'

基础archive布局示例（_layouts/archive.html） #

---
layout: default
---
<h1>{% if page.type == 'category' %}分类：{{ page.title }}{% elsif page.type == 'tag' %}标签：{{ page.title }}{% endif %}</h1>
<div class="archive-posts">
  {% for post in page.posts %}
    <article>
      <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
      <time>{{ post.date | date: "%Y年%m月%d日" }}</time>
    </article>
  {% endfor %}
</div>

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