如何在Ruby 3环境中使用Jekyll GitHub Pages并解决本地服务报错

方案一：切换到兼容的Ruby版本 #

GitHub Pages官方旧版github-pages gem（对应Jekyll 3.x）仅兼容Ruby 2.7.x及以下版本，这是最稳妥的解决方法：

• 用Ruby版本管理器（如rbenv、rvm）安装2.7.x版本，比如：

  rbenv install 2.7.8
  rbenv local 2.7.8
  

• 重新执行依赖安装和服务启动：

  bundle install
  bundle exec jekyll serve
  

本地使用和GitHub Pages服务器一致的Ruby版本，还能保证预览效果和线上完全匹配。

方案二：升级GitHub Pages到兼容Ruby 3的版本 #

如果你的项目可以适配新版Jekyll，尝试更新github-pages到最新版本：

• 修改项目根目录的Gemfile，确保github-pages的引用是：

  gem "github-pages", group: :jekyll_plugins
  

• 执行更新命令：

  bundle update github-pages
  

新版github-pages依赖Jekyll 4.x及以上，已经修复了Ruby 3的兼容问题，但需要检查项目的_config.yml配置是否有过时选项，避免出现新的报错。

方案三：手动锁定兼容的依赖版本（不推荐） #

如果暂时无法切换Ruby版本或升级GitHub Pages，可以尝试锁定引发错误的依赖版本：

• 查找报错相关的gem（通常是liquid或某个Jekyll插件），在Gemfile中指定兼容Ruby 3的旧版本，比如：

  gem "liquid", "~> 4.0.4"
  

• 执行bundle install更新依赖，但这种方法容易引发其他依赖冲突，仅作为临时应急方案。

内容的提问来源于stack exchange，提问作者D.W.