Jekyll插件本地运行正常但Travis CI上失效求助

我之前也碰到过类似的情况，咱们一步步来排查可能的原因，逐个解决：

1. 先排查GitHub Pages依赖的冲突问题 #

你Gemfile里同时用了github-pages和octopress-minify-html，这里大概率存在版本兼容问题。github-pages会锁定一套固定版本的Jekyll和配套插件，Travis CI会严格按照这个锁文件安装依赖，但本地环境可能没做严格限制，所以插件能正常运行。

试试这么做：

• 本地执行bundle show github-pages，查看它依赖的Jekyll版本。
• 查一下octopress-minify-html的说明文档，确认它支持的Jekyll版本范围，如果和前者不匹配，就在Gemfile里指定兼容的插件版本，比如：

  gem "octopress-minify-html", "~> 1.3.0" # 替换成你确认兼容的版本号
  

2. 检查CI环境的Jekyll运行环境变量 #

很多压缩类插件默认只在生产环境下工作，你本地可能已经设置了JEKYLL_ENV=production，但Travis默认不会添加这个变量，导致插件没被触发运行。

调整.travis.yml：
把script行改成这样：

script: JEKYLL_ENV=production bundle exec jekyll build

同时别忘了在_config.yml里确认插件已启用：

plugins:
  - octopress-minify-html
# 如果你用的是旧版Jekyll，就换成gems配置：
# gems:
#   - octopress-minify-html

3. 确认Ruby版本和本地一致 #

Travis默认的Ruby版本可能和你本地使用的不一样，版本差异很容易导致插件安装或运行出错。

指定Ruby版本：
在.travis.yml里添加你本地使用的Ruby版本，比如你本地用的是2.7.6，就加上：

rvm: 2.7.6

4. 查看Travis构建日志的报错细节 #

最直接的方法是登录Travis CI后台，查看对应项目的构建日志，搜索octopress-minify-html相关的关键词，看看有没有加载失败、依赖缺失的报错信息。如果找到具体错误，比如某个依赖未安装，直接在Gemfile里添加对应的依赖即可。

最后验证一下 #

修改完配置后，先在本地模拟Travis的环境运行一遍：

JEKYLL_ENV=production bundle exec jekyll build

如果本地能正常生成压缩后的HTML，再推送代码到GitHub触发Travis构建，应该就能解决问题了。

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