You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

运行Jekyll项目报错:Ruby版本3.0.2与Gemfile指定2.7.1不匹配如何解决

解决方案

你需要通过Ruby版本管理工具安装项目要求的2.7.1版本,无需修改Gemfile即可解决版本不匹配问题,以下是适配zsh+ohmyzsh环境的操作步骤:

  • 第一步:安装Ruby版本管理工具rbenv及编译插件
    macOS环境可直接通过Homebrew安装:brew install rbenv ruby-build;Linux环境可通过git克隆官方仓库完成安装
  • 第二步:配置zsh环境变量
    执行命令将rbenv初始化逻辑写入zsh配置文件:echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc,随后执行source ~/.zshrc让配置立即生效
  • 第三步:安装指定版本Ruby
    执行命令安装项目要求的2.7.1版本:rbenv install 2.7.1,安装过程耗时较长请勿中断
  • 第四步:为项目单独绑定Ruby版本
    进入项目根目录后执行:rbenv local 2.7.1,该命令会在项目下生成.ruby-version文件用于rbenv识别版本,不会修改Gemfile,你可以将该文件加入.gitignore避免提交到公共仓库
  • 第五步:验证版本并重新安装依赖
    执行ruby -v确认输出为2.7.1版本后,执行bundle install重新安装项目依赖,完成后再执行bundle exec jekyll serve即可正常启动服务

若你已安装过rbenv,可直接从第三步开始操作。如果安装Ruby 2.7.1时出现编译报错,macOS可先执行xcode-select --install安装Xcode命令行工具,Linux可先安装libssl-dev、libreadline-dev等基础编译依赖。你也可以选择RVM作为替代版本管理工具,安装完成后执行rvm install 2.7.1,再在项目目录执行rvm use 2.7.1即可实现同样效果。

内容的提问来源于stack exchange,提问作者Alex H

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.03 02:48:03