Mac环境下搭建GitHub Pages(Jekyll)遇Gem及Ruby安装错误求助

一、修复rbenv编译Ruby 3.0.5失败的问题 #

MacOS 10.15（Catalina）的系统限制和依赖版本不匹配是编译失败的核心原因，按以下步骤操作：

• 重装适配Catalina的Command Line Tools：

  sudo rm -rf /Library/Developer/CommandLineTools
  xcode-select --install
  

  弹出安装窗口后完成全程，确保工具版本与系统兼容。
• 安装Ruby编译必需的依赖：

  brew install openssl@1.1 readline libyaml
  

  （注：Catalina对新版openssl兼容性差，指定安装1.1版本）
• 指定依赖路径编译安装Ruby 3.0.5：

  RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@1.1) --with-readline-dir=$(brew --prefix readline) --with-libyaml-dir=$(brew --prefix libyaml)" rbenv install 3.0.5
  

• 设置Ruby版本并刷新环境：

  rbenv global 3.0.5
  rbenv rehash
  

  验证版本：ruby -v 应显示3.0.5

二、安装Jekyll与Bundler #

使用rbenv管理的用户级Ruby，无需sudo即可正常安装：

gem install jekyll bundler

验证Jekyll安装：jekyll -v 应显示对应版本号

三、重新初始化Jekyll项目 #

回到目标目录执行初始化命令：

jekyll new --skip-bundle .

为什么之前的方法无效？ #

• MacOS 10.15的系统分区是只读状态，系统自带Ruby的gem安装目录属于系统级，即使sudo也无法绕过权限限制，导致直接安装Jekyll失败。
• 未指定编译依赖路径时，rbenv找不到适配Catalina的openssl等库，导致Ruby编译失败。

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