Vercel部署Jekyll(Chirpy主题)报错：Ruby版本不匹配求助

方案1：通过Vercel项目配置强制指定Ruby版本 #

进入Vercel项目的「Settings」→「General」→「Build & Development Settings」，找到「Ruby Version」选项，直接输入3.0.0及以上版本（比如3.2.2），保存后重新触发部署。

方案2：添加.ruby-version文件锁定版本 #

在项目根目录创建.ruby-version文件，内容写入目标Ruby版本号：

3.2.2

Vercel会优先读取该文件的版本配置，覆盖默认环境版本。

方案3：修改构建命令强制切换Ruby版本 #

在Vercel的「Build Command」中替换默认命令，手动通过rbenv切换版本：

rbenv install 3.2.2 && rbenv global 3.2.2 && bundle install && bundle exec jekyll build

若上述方案无效，兼容Ruby 2.7.0的Jekyll主题推荐 #

• Minimal Mistakes：功能全面，支持Ruby 2.6+，自定义性强，适合各类静态博客
• Just the Docs：轻量简洁的文档类主题，兼容Ruby 2.5+，适合技术文档站点
• Hyde：极简风格博客主题，依赖少，适配低版本Ruby环境
• Lanyon：基于Poole的简约主题，对Ruby版本要求低，适合个人博客搭建

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