Mac如何安装配置Ruby环境_Mac Ruby环境安装配置方案

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

很多Mac开发者都遇到过这样的问题：系统自带的Ruby版本太旧，或者项目要求特定的版本，这时候就需要自己动手搭建一个独立的Ruby环境了。别担心，这事儿其实不难，关键在于选对方法。市面上主流的安装配置方案有好几种，各有各的适用场景，咱们这就来逐一拆解。

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

如果你刚接触Ruby，或者对版本切换没有频繁需求，那么Homebrew绝对是你的首选。它的优势在于“省心”——直接安装预编译好的二进制包，无需自己动手编译，速度飞快。而且，Homebrew会自动处理好依赖关系，无论是Apple Silicon还是Intel芯片的Mac，它都能完美适配。

具体操作，跟着下面几步走就行：

1、安装 Xcode 命令行工具：这是很多开发工具的基础，先在终端里执行 xcode-select --install，然后跟着提示完成安装。

2、安装 Homebrew：如果还没装Homebrew，执行这条命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，耐心等待安装完成。

3、更新并安装 Ruby：依次运行 brew update 和 brew install ruby。前者是更新Homebrew本身，确保软件列表是最新的。

4、配置环境变量：安装完成后，需要把Ruby的可执行文件路径加到系统环境里。执行 echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc 即可。

5、重新加载配置：让刚才的配置立刻生效，运行 source ~/.zshrc。

6、验证安装：最后，执行 ruby -v 和 gem -v。如果输出的Ruby版本不是系统自带的那个老版本（比如显示为 ruby 3.3.0 或更高），那就恭喜你，安装成功了。

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

当你需要同时处理多个Ruby项目，而每个项目要求的版本又不一样时，一个轻量级的版本管理工具就至关重要了。rbenv正是为此而生，它允许你在同一台电脑上安装并切换多个Ruby版本，而且支持全局、项目目录、甚至单个Shell会话三种级别的切换，灵活性极高，特别适合团队协作场景。

来看看怎么部署：

1、安装 rbenv 及 ruby-build 插件：通过Homebrew安装最方便，执行 brew install rbenv ruby-build。ruby-build插件是用来编译安装不同Ruby版本的。

2、初始化 rbenv：运行 rbenv init -zsh，它会输出一行命令，类似 eval "$(rbenv init -zsh)"。把这行命令复制下来，粘贴到你用户目录下的 ~/.zshrc 文件末尾。

3、重新加载配置：执行 source ~/.zshrc，让初始化设置生效。

4、列出可安装版本：运行 rbenv install -l，可以查看所有能安装的Ruby版本列表。

5、安装指定版本：比如要安装3.1.4版，就执行 rbenv install 3.1.4。这个过程会从源码编译，需要一点时间，并且确保你已经安装了Xcode命令行工具。

6、设为全局默认：安装好后，执行 rbenv global 3.1.4，将它设置为全局默认版本。

7、验证生效：最后，再运行一次 ruby -v，如果显示类似 ruby 3.1.4p223 的内容，说明一切就绪。

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

如果你是专注于Ruby或Rails开发的“硬核玩家”，那么RVM（Ruby Version Manager）可能更对你的胃口。它不仅仅管理Ruby版本，还内置了强大的Gemset功能，可以为不同的项目创建完全独立的gem集合，彻底解决依赖冲突的烦恼。功能更全，当然学习曲线也略陡一些。

部署步骤如下：

1、安装 RVM：在终端中执行这条命令：curl -sSL https://get.rvm.io | bash -s stable。

2、载入 RVM 环境：安装完成后，运行 source ~/.rvm/scripts/rvm 来加载RVM。

3、设置国内镜像源（加速下载）：为了提升在国内下载Ruby源码的速度，建议执行 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，把rbenv的执行路径加入系统环境。

3、启用初始化脚本：接着执行 echo 'eval "$(~/.rbenv/bin/rbenv init -zsh)"' >> ~/.zshrc，让rbenv在Shell启动时自动初始化。

4、安装 ruby-build 插件：同样通过Git克隆的方式安装这个必备插件：git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build。

5、重新加载配置：执行 source ~/.zshrc，让所有配置生效。

6、后续操作同方案二第4–7步：至此，一个手动部署的rbenv环境就准备好了。接下来，你就可以像在第二个方案中一样，使用 rbenv install 安装版本，并用 rbenv global 来设定默认版本了。