配置 macOS 上的 Ruby 开发环境

发布于:2025-06-10 ⋅ 阅读:(38) ⋅ 点赞:(0)

🚀 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 后,为了让终端识别 railsbundle 等命令,必须加入 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 无法自动识别终端的解释器,需要手动设置:

  1. 打开 RubyMine → 新建项目;
  2. 点击「未选择解释器」右侧的
  3. 路径选择:
/opt/homebrew/opt/ruby/bin/ruby
  1. 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

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


📦 总结:关键工具说明

工具 作用
Ruby 编程语言,适合脚本与 Web 开发
Rails Ruby 的 Web 开发框架
Bundler Gem 管理工具,类似 npm/pip
RubyMine JetBrains 出品的 Ruby IDE
Homebrew macOS 下推荐的包管理器