配置 macOS 上的 Ruby 开发环境

🚀 macOS 从零搭建 Ruby 开发环境（含 RubyMine 配置）

面向初学者的完整入门指南：包含 Ruby、Rails、Bundler 安装、环境变量配置以及 RubyMine IDE 集成

📌 为什么选择 Ruby？

💎 Ruby 是什么？

Ruby 是一门语法简洁、易读易写、灵活强大的脚本语言，广泛用于：

• Web 应用开发（如 GitHub、Shopify 就用 Ruby on Rails）
• 命令行工具和自动化脚本
• 数据处理、小型程序开发

它追求“程序员的幸福感”，适合快速开发和迭代。

🌐 Rails 是什么？

Ruby on Rails（简称 Rails）是用 Ruby 写的 Web 应用框架，主打：

• 快速开发：内置生成器、MVC 架构、丰富工具链；
• 开箱即用：带数据库 ORM、表单处理、邮箱、API 等模块；
• 社区强大：文档完善、插件丰富、很多成功案例。

适合构建博客、后台系统、RESTful API 服务等现代 Web 应用。

📦 Bundler 是做什么的？

Bundler 是 Ruby 的依赖管理工具，功能类似：

• Python 的 pip + requirements.txt；
• Node.js 的 npm + package.json。

它用于：

• 管理项目所需 gem；
• 锁定 gem 版本，生成 Gemfile.lock；
• 快速部署、保障一致性。

🧰 环境准备

确保你已准备好：

• 一台 macOS 电脑（M1/M2/M3 或 Intel）
• 安装 Homebrew
• 安装 RubyMine（JetBrains 出品的 Ruby 专业 IDE，推荐）

✅ 第一步：查看系统自带 Ruby

macOS 默认已安装旧版 Ruby，打开终端运行：

ruby -v

可能输出：

ruby 2.6.10p210 (...)

✅ 虽然 Ruby 已安装，但版本过旧，不建议用它开发 Rails 项目。

🧱 第二步：通过 Homebrew 安装最新版 Ruby

brew install ruby

安装后 Ruby 通常位于：

/opt/homebrew/opt/ruby/bin/ruby

⚙️ 第三步：配置 Ruby 环境变量

我们需要将新安装的 Ruby 加入系统 PATH，让终端优先使用新版 Ruby。

🔹 配置 Ruby 可执行路径

打开终端：

nano ~/.zshrc

添加以下内容：

# Homebrew 安装的 Ruby 可执行路径
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"

保存后执行：

source ~/.zshrc

验证是否生效：

ruby -v
which ruby

📦 第四步：安装 Rails 和 Bundler

安装 Rails：

gem install rails
gem install bundler

验证：

rails -v     # Rails 8.0.2
bundler -v   # Bundler 2.6.9

⚙️ 第五步：配置 gem 可执行路径（否则 rails 命令无法用）

安装完 Rails 后，你会发现：

rails -v
# 报错：zsh: command not found: rails

说明 gem 安装成功，但 gem 的 bin 路径还没加入 PATH。

🔍 确认 rails 安装位置

运行这个命令找出 rails 命令装到哪里了：

gem which rails

然后再找出 rails 可执行文件：

gem env

输出中你可以找到 EXECUTABLE DIRECTORY 这一项，例如：

EXECUTABLE DIRECTORY: /opt/homebrew/lib/ruby/gems/3.4.4/bin

那么就需要把这个路径加入你的 PATH。

🧠 .zshrc 中 gem 执行路径的两种方式比较

安装 Ruby 和 Rails 后，为了让终端识别 rails、bundle 等命令，必须加入 gem 的可执行目录。

✅ 方法一：写死版本路径

export PATH="/opt/homebrew/lib/ruby/gems/3.4.4/bin:$PATH"

• ✅ 立即生效
• ❌ 升级 Ruby 后路径失效

✅ 方法二：动态获取路径（推荐）

export PATH="$(ruby -e 'puts Gem.bindir'):$PATH"

• ✅ 自动匹配当前 Ruby 版本的 gem 路径
• ✅ Ruby 升级后无需修改
• ❌ 初学者可能不易理解

📋 对比总结表

🔧 最终推荐 .zshrc 配置如下：

# Ruby 可执行路径（ruby, irb）
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"

# gem 可执行路径（rails, bundler 等）
export PATH="$(ruby -e 'puts Gem.bindir'):$PATH"

执行：

source ~/.zshrc

验证：

rails -v
which rails

💻 第六步：在 RubyMine 中配置解释器

RubyMine 无法自动识别终端的解释器，需要手动设置：

1. 打开 RubyMine → 新建项目；
2. 点击「未选择解释器」右侧的 ➕；
3. 路径选择：

/opt/homebrew/opt/ruby/bin/ruby

5. RubyMine 将显示 ruby 3.4.4，点击确定即可。

🧪 第七步：创建并运行项目

✅ 普通 Ruby 项目

1. RubyMine 中新建空项目；

2. 创建文件 hello.rb，内容如下：

   puts "Hello from RubyMine!"
   

3. 右键 → Run 运行。

✅ Rails 项目（建议在终端中创建）

rails new myapp
cd myapp
bundle install
rails server

打开浏览器访问：

http://localhost:3000

看到欢迎页说明运行成功 🎉

📦 总结：关键工具说明