Mac上搭建Ruby开发环境有四种方案：一、Homebrew安装（推荐新手）；二、rbenv管理多版本（推荐协作）；三、RVM管理带Gemset隔离（适合Ruby/Rails开发者）；四、手动克隆rbenv（适用于受限环境）。

如果您在Mac上需要搭建Ruby开发环境，但系统自带的Ruby版本过旧或无法满足项目需求，则需手动安装并配置独立的Ruby运行时。以下是多种可行的安装配置方案：

一、使用 Homebrew 安装 Ruby（推荐新手）

该方式通过 Homebrew 包管理器直接安装预编译的 Ruby 二进制包，无需编译，安装快速且路径清晰，适合对版本切换无高频需求的用户。Homebrew 同时自动处理依赖并适配 Apple Silicon 与 Intel 架构。

1、安装 Xcode 命令行工具：在终端中执行 xcode-select --install，按提示完成安装。

2、安装 Homebrew：执行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，等待安装完成。

3、更新并安装 Ruby：依次运行 brew update 和 brew install ruby。

4、配置环境变量：将 Ruby 可执行路径写入 shell 配置文件，执行 echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc。

5、重新加载配置：运行 source ~/.zshrc。

6、验证安装：执行 ruby -v 与 gem -v，确认输出非系统默认版本（如 ruby 3.3.0）。

二、使用 rbenv 管理多版本 Ruby（推荐项目协作）

rbenv 是轻量级版本管理工具，允许在同一台 Mac 上共存多个 Ruby 版本，并支持全局、局部（目录级）、Shell 级三重作用域切换，适用于需兼容不同 Ruby 版本的工程场景。

1、安装 rbenv 及 ruby-build 插件：执行 brew install rbenv ruby-build。

2、初始化 rbenv：运行 rbenv init -zsh，复制输出中类似 eval "$(rbenv init -zsh)" 的行，粘贴至 ~/.zshrc 文件末尾。

3、重新加载配置：执行 source ~/.zshrc。

4、列出可安装版本：运行 rbenv install -l，查看可用版本列表。

5、安装指定版本（例如 3.1.4）：执行 rbenv install 3.1.4，等待编译完成（需已安装 Xcode Command Line Tools）。

6、设为全局默认：运行 rbenv global 3.1.4。

7、验证生效：执行 ruby -v，应显示 ruby 3.1.4p223 类似内容。

三、使用 RVM 安装并管理 Ruby（适合 Ruby 专属开发者）

RVM（Ruby Version Manager）是功能完备的 Ruby 环境管理器，内置 Gemset 隔离机制，可为不同项目分配独立的 gem 集合，避免依赖冲突，适合深度 Ruby 或 Rails 开发者。

1、安装 RVM：执行 curl -sSL https://get.rvm.io | bash -s stable。

2、载入 RVM 环境：运行 source ~/.rvm/scripts/rvm。

3、设置国内镜像源（加速下载）：执行 echo "ruby_url=https://cache.ruby-china.org/pub/ruby" > ~/.rvm/user/db。

4、安装 Ruby 版本（例如 3.2.2）：运行 rvm install 3.2.2。

5、设为默认使用版本：执行 rvm use 3.2.2 --default。

6、验证安装：运行 ruby -v 与 rvm list，确认当前版本及状态标记为 => 。

四、手动克隆安装 rbenv（适用于受限环境）

当无法使用 Homebrew（如企业内网限制、权限受限或需调试最新开发版 rbenv）时，可通过 Git 克隆源码方式部署 rbenv，完全绕过包管理器依赖，具备最高可控性。

1、克隆 rbenv 到主目录：执行 git clone https://github.com/rbenv/rbenv.git ~/.rbenv。

2、添加 rbenv 路径至环境变量：运行 echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc。

3、启用初始化脚本：执行 echo 'eval "$(~/.rbenv/bin/rbenv init -zsh)"' >> ~/.zshrc。

4、安装 ruby-build 插件：运行 git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build。

5、重新加载配置：执行 source ~/.zshrc。

6、后续操作同方案二第4–7步：使用 rbenv install 与 rbenv global 完成版本安装与设定。