Ruby 3.1环境下Jekyll完全无法运行的原因及报错咨询

问题重现 #

• 在Ruby 3.1环境执行：

  gem install jekyll
  

• 执行版本检查命令：

  jekyll -v
  

• 触发错误：

  `require': cannot load such file -- sass-embedded (LoadError)
  

• 尝试升级至Ruby 3.2.0-preview1后出现更多错误

解决方案 #

1. 手动安装sass-embedded依赖 #

Jekyll 4.3+ 默认依赖sass-embedded而非旧版sass，部分环境下自动安装可能失败，手动执行以下命令安装：

gem install sass-embedded

安装完成后再次运行jekyll -v验证。

2. 回退到兼容Ruby 3.1的Jekyll版本 #

如果sass-embedded安装仍有问题，可指定安装不依赖它的旧版Jekyll（如4.2.x系列），该版本对Ruby 3.1兼容性更稳定：

gem install jekyll -v 4.2.2

3. 放弃Ruby预览版使用 #

Ruby 3.2.0-preview1属于预发布版本，存在大量未修复的兼容性问题，不适合用于日常开发。保持使用Ruby 3.1.x稳定版本即可，无需升级至预览版。

4. 清理Gem缓存后重新安装 #

若之前的安装残留导致依赖冲突，可清理缓存后重新安装：

gem cleanup
gem uninstall jekyll sass-embedded
gem install jekyll

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