文章

macOS 上通过 rbenv 环境管理器安装/升级 ruby

本文记录在 macOS 上通过 rbenv 环境管理器安装/升级 ruby 的操作流程。

macOS 上通过 rbenv 环境管理器安装/升级 ruby

1.安装 Homebrew

Homebrew 是 macOS 上的包管理器,可以简化安装和管理第三方软件包的过程。

安装过程参考官方网站:https://brew.sh/zh-cn/ (安装过程中可能需要输入管理员密码)

2.安装 rbenv 和 ruby-build

1
brew install rbenv ruby-build

安装完成后使用 rbenv -v 命令查看安装的 rbenv 版本。

3.初始化 rbenv

1.将 rbenv 初始化脚本添加到你的 shell 配置文件中(如 ~/.zprofile 等):

1
rbenv init

2.使用 source 命令重新加载 shell 配置文件,使更改生效:

1
source ~/.zprofile  # 或者对应的配置文件

4.安装 Ruby 版本

1.查看可用的 Ruby 版本

使用 rbenv install --list 命令查看所有可用的 Ruby 版本。

2.安装特定的 Ruby 版本

选择一个你需要的 Ruby 版本,并使用 rbenv install 命令进行安装。例如,安装 Ruby 3.3.6:

1
rbenv install 3.3.6

5.设置和验证 Ruby 版本

1.设置全局 Ruby 版本

使用 rbenv global 命令设置全局默认的 Ruby 版本:

1
rbenv global 3.3.6

2.验证安装

使用 ruby -v 命令验证当前正在使用的 Ruby 版本。如果一切配置正确,你应该会看到类似于以下的输出:

1
ruby 3.3.6 (xxxx-xx-xx revision xxxxxxxxxx) [arm64-darwin23]

6.其他注意事项

如果你需要为特定项目设置不同的 Ruby 版本,可以在项目根目录下创建一个 .ruby-version 文件,并在其中指定所需的 Ruby 版本号。

然后,在该项目目录下运行 rbenv local 命令(实际上,rbenv 会自动读取 .ruby-version 文件并应用相应的版本,无需手动运行 rbenv local)。

每次安装新的 Ruby 版本或 gem 后,建议运行 rbenv rehash 命令来更新 shims 目录中的可执行文件链接。

本文由作者按照 CC BY 4.0 进行授权