配置 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，打开终端运行：

bash 复制代码

ruby -v

可能输出：

复制代码

ruby 2.6.10p210 (...)

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

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

bash 复制代码

brew install ruby

安装后 Ruby 通常位于：

复制代码

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

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

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

🔹 配置 Ruby 可执行路径

打开终端：

bash 复制代码

nano ~/.zshrc

添加以下内容：

bash 复制代码

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

保存后执行：

bash 复制代码

source ~/.zshrc

验证是否生效：

bash 复制代码

ruby -v
which ruby

📦 第四步：安装 Rails 和 Bundler

安装 Rails：

bash 复制代码

gem install rails
gem install bundler

验证：

bash 复制代码

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

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

安装完 Rails 后，你会发现：

bash 复制代码

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

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

🔍 确认 `rails` 安装位置

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

bash 复制代码

gem which rails

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

bash 复制代码

gem env

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

复制代码

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

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

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

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

✅ 方法一：写死版本路径

bash 复制代码

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

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

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

bash 复制代码

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` 配置如下：

bash 复制代码

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

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

执行：

bash 复制代码

source ~/.zshrc

验证：

bash 复制代码

rails -v
which rails

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

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

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

/opt/homebrew/opt/ruby/bin/ruby
RubyMine 将显示 ruby 3.4.4，点击确定即可。

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

✅ 普通 Ruby 项目

RubyMine 中新建空项目；
创建文件 hello.rb，内容如下：
ruby 复制代码
```
puts "Hello from RubyMine!"
```
右键 → Run 运行。

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

bash 复制代码

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 下推荐的包管理器

配置 macOS 上的 Ruby 开发环境

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

📌 为什么选择 Ruby？

💎 Ruby 是什么？

🌐 Rails 是什么？

📦 Bundler 是做什么的？

🧰 环境准备

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

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

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

🔹 配置 Ruby 可执行路径

📦 第四步：安装 Rails 和 Bundler

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

🔍 确认 rails 安装位置

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

✅ 方法一：写死版本路径

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

📋 对比总结表

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

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

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

✅ 普通 Ruby 项目

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

📦 总结：关键工具说明

🔍 确认 `rails` 安装位置

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

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