🚀 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 升级后无需修改
- ❌ 初学者可能不易理解
📋 对比总结表
| 配置方式 | 优点 | 缺点 | 推荐程度 |
|---|---|---|---|
export PATH="/固定版本路径/bin:$PATH" | 直接、可见 | Ruby 升级后需手动修改 | ❌ 不推荐 |
export PATH="$(ruby -e 'puts Gem.bindir'):$PATH" | 动态适配、通用性强 | 语法稍复杂 | ✅ 推荐方式 |
🔧 最终推荐 .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 无法自动识别终端的解释器，需要手动设置：
- 打开 RubyMine → 新建项目；
- 点击「未选择解释器」右侧的 ➕；
- 路径选择：
/opt/homebrew/opt/ruby/bin/ruby
- RubyMine 将显示
ruby 3.4.4，点击确定即可。
🧪 第七步：创建并运行项目
✅ 普通 Ruby 项目
-
RubyMine 中新建空项目；
-
创建文件
hello.rb，内容如下：puts "Hello from RubyMine!" -
右键 → Run 运行。
✅ Rails 项目（建议在终端中创建）
rails new myapp
cd myapp
bundle install
rails server
打开浏览器访问：
http://localhost:3000
看到欢迎页说明运行成功 🎉
📦 总结：关键工具说明
| 工具 | 作用 |
|---|---|
| Ruby | 编程语言，适合脚本与 Web 开发 |
| Rails | Ruby 的 Web 开发框架 |
| Bundler | Gem 管理工具，类似 npm/pip |
| RubyMine | JetBrains 出品的 Ruby IDE |
| Homebrew | macOS 下推荐的包管理器 |
