macos上推荐使用rvm、rbenv或homebrew安装ruby:先装xcode命令行工具和homebrew,再依需选rvm(多版本管理)、rbenv(轻量可控)或homebrew(单版本快捷),最后验证ruby -v。

如果您在 macOS 上需要安装 Ruby 语言环境,但系统自带的 Ruby 版本过旧(如 2.6.x 或更低),或需灵活管理多个 Ruby 版本,则需通过第三方工具进行安装与配置。以下是针对 Mac 平台安装 Ruby 及 RVM 的具体操作步骤:
一、安装 Xcode 命令行工具
这是编译 Ruby 源码及依赖库所必需的基础开发组件,缺少它会导致后续安装失败。
1、打开终端应用程序。
2、执行命令:xcode-select --install。
3、在弹出窗口中点击“安装”,等待下载完成并接受许可协议。
二、安装 Homebrew 包管理器
Homebrew 是 macOS 上最主流的开源软件包管理工具,用于简化 rbenv、RVM 等工具及其依赖的安装流程。
1、在终端中运行以下命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、按提示输入管理员密码,等待安装完成。
3、执行 brew doctor 验证安装状态,确保无警告错误。
三、使用 RVM 安装并管理 Ruby
RVM(Ruby Version Manager)支持在同一系统中安装、切换和隔离多个 Ruby 版本,适合需要多版本共存的开发场景。
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 版本:rvm list known。
5、安装指定版本(例如 3.1.6):rvm install 3.1.6。
PyCharm 2026.2.0.1 Mac版提供 JetBrains 官方 2026.2.0.1 版本安装包,适合在macOS系统上进行 Python 项目开发、运行、调试和测试。
6、设为默认全局版本:rvm use 3.1.6 --default。
7、验证安装结果:ruby -v && gem -v。
四、使用 rbenv 安装并管理 Ruby
rbenv 是轻量级 Ruby 版本管理工具,不劫持 shell 函数,更适合追求简洁与可控性的用户。
1、通过 Homebrew 安装 rbenv 及 ruby-build 插件:brew install rbenv ruby-build。
2、初始化 rbenv 并写入 shell 配置文件(以 zsh 为例):echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc && source ~/.zshrc。
3、查看可安装版本列表:rbenv install -l。
4、安装 Ruby 3.1.6:rbenv install 3.1.6。
5、设置全局版本:rbenv global 3.1.6。
6、验证是否生效:ruby -v 应返回 3.1.6,且 which ruby 输出路径包含 .rbenv/shims。
五、直接使用 Homebrew 安装 Ruby(单版本快速部署)
若仅需一个稳定、维护良好的 Ruby 版本,且无需频繁切换,此方法最为简洁高效。
1、执行安装命令:brew install ruby@3.1。
2、将 Homebrew 安装的 Ruby 路径加入 PATH:echo 'export PATH="/opt/homebrew/opt/ruby@3.1/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc。
3、检查是否已覆盖系统默认 Ruby:which ruby 应指向 /opt/homebrew/opt/ruby@3.1/bin/ruby。
4、运行 ruby -v 和 gem env 确认版本与 gem 路径正确。










