M2芯片Mac Sonoma 14.1环境下正确安装Ruby的可行步骤求助

一、清理旧环境残留（避免版本冲突） #

• 卸载并清理之前的Ruby版本管理工具残留：

# 清理rvm
rvm implode && rm -rf ~/.rvm
# 清理asdf的Ruby插件
rm -rf ~/.asdf/plugins/ruby
# 清理rbenv的失败版本缓存
rm -rf ~/.rbenv/versions/3.2.2
rm -rf /var/folders/bg/hx4gy68d1sn9w8yyxc5r9g800000gn/T/ruby-build*

二、安装编译依赖库（适配Sonoma） #

• 更新Homebrew并升级所有包：

brew update && brew upgrade

• 安装Ruby编译必需的依赖：

brew install openssl readline libyaml gmp ffi

三、配置环境变量（让安装脚本找到依赖） #

• 将以下内容追加到你的Shell配置文件（~/.zshrc 或 ~/.bash_profile，根据你使用的Shell）：

# Ruby依赖路径配置
export PATH="/usr/local/opt/openssl/bin:$PATH"
export PATH="/usr/local/opt/readline/bin:$PATH"
export PATH="/usr/local/opt/libyaml/bin:$PATH"
export PATH="/usr/local/opt/gmp/bin:$PATH"
export PATH="/usr/local/opt/ffi/bin:$PATH"

export LDFLAGS="-L/usr/local/opt/openssl/lib -L/usr/local/opt/readline/lib -L/usr/local/opt/libyaml/lib -L/usr/local/opt/gmp/lib -L/usr/local/opt/ffi/lib"
export CPPFLAGS="-I/usr/local/opt/openssl/include -I/usr/local/opt/readline/include -I/usr/local/opt/libyaml/include -I/usr/local/opt/gmp/include -I/usr/local/opt/ffi/include"
export PKG_CONFIG_PATH="/usr/local/opt/openssl/lib/pkgconfig /usr/local/opt/readline/lib/pkgconfig /usr/local/opt/libyaml/lib/pkgconfig /usr/local/opt/gmp/lib/pkgconfig /usr/local/opt/ffi/lib/pkgconfig"

• 生效配置：

source ~/.zshrc # 若使用bash则执行 source ~/.bash_profile

四、用rbenv安装Ruby（推荐方案） #

• 确保ruby-build工具是最新版本：

brew upgrade ruby-build

• 安装Ruby 3.2.2（指定ffi路径解决编译报错）：

RUBY_CONFIGURE_OPTS="--with-ffi-dir=$(brew --prefix ffi)" rbenv install 3.2.2

• 若3.2.2仍失败，尝试安装兼容性更好的Ruby 3.3.0：

RUBY_CONFIGURE_OPTS="--with-ffi-dir=$(brew --prefix ffi)" rbenv install 3.3.0

五、设置Ruby版本并安装CocoaPods #

• 设置全局Ruby版本：

rbenv global 3.2.2 # 若安装的是3.3.0则替换为对应版本号

• 刷新rbenv环境：

rbenv rehash

• 安装CocoaPods：

gem install cocoapods

备用方案：直接通过Homebrew安装Ruby #

若上述rbenv方案仍失败，可尝试直接用Homebrew安装：

brew install ruby

• 将Homebrew Ruby加入环境变量优先级（避免系统Ruby干扰）：

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

• 安装CocoaPods：

gem install cocoapods

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