欢迎来到这篇升级版指南！作为一名在 2026 年依然活跃的开发者，我们知道 macOS 凭借其 Unix 底层和强大的性能，依然是 Ruby on Rails 开发的首选环境。但技术在进化，仅仅“跑通”代码已不再是我们的目标。在这个 AI 辅助编程和云原生架构落地的时代，我们需要的是一个既符合现代工程标准，又能与智能工具无缝协作的开发环境。在这篇文章中，我们将深入探讨如何在 macOS 上搭建一个面向未来的 Rails 开发环境，不仅关注基础配置，更会融入 2026 年的主流开发范式。
为什么我们需要关心安装过程？
在你真正开始敲代码之前，建立一个正确的环境至关重要。许多初学者往往直接使用 macOS 系统自带的 Ruby，这通常会埋下难以排查的隐患。我们将首先分析“系统自带 Ruby”与“独立环境”的区别，带你了解其中的利弊，并使用 RVM（Ruby Version Manager）来打造一个完美的开发沙盒，为后续接入 AI 辅助工具打下基础。
通过阅读这篇文章，你将学会：
- 理解系统环境：为什么不能用系统的 Ruby？什么是 RVM？
- 安装 RVM：掌握版本管理的利器。
- 安装 Ruby：如何获取最新的稳定版本并设为默认。
- 安装 Rails：优化 gem 安装过程，加速配置。
- 实战演练：创建并运行你的第一个 Rails 应用，验证环境是否成功。
深入理解 Ruby on Rails 及其环境
在我们动手之前，让我们先聊聊什么是 Ruby on Rails，以及为什么它在 2026 年依然深受开发者喜爱，特别是在结合了 Agentic AI（自主智能体）开发之后。
Ruby on Rails（通常简称为 Rails）是一个基于 Ruby 编程语言编写的服务器端 Web 应用开发框架。它最核心的理念是“约定优于配置”，这大大减少了我们在做决策时的时间消耗，让我们能更专注于业务逻辑本身。
#### 为什么要选择 Ruby on Rails？
- 非常适合快速应用程序开发 (RAD)：在 AI 辅助编码的时代，Rails 这种生成代码的能力与 AI 的补全能力相得益彰。我们可以通过极少的代码生成完整的应用骨架，再由 AI 辅助填充细节。
- 全栈型框架与 AI 集成：Rails 7+ 及后续版本对前端构建工具的简化，使得我们更容易将其与基于 LLM（大语言模型）的前端界面集成。
- 强大的生态系统：RubyGems 的庞大资源意味着我们几乎不需要重复造轮子，包括市面上最新出现的 AI SDK 封装。
步骤 1：审视 macOS 的系统 Ruby
在开始安装之前，让我们打开终端，看看系统里有什么。
# 检查系统自带的 Ruby 版本
/usr/bin/ruby --version
macOS 通常会在 /usr/bin/ruby 路径下预装了一个版本（比如 Ruby 2.6 或 2.7）。然而，我们强烈建议不要直接使用系统预装的这个 Ruby 版本。原因主要有两点：
- 权限受限：系统 Ruby 归 root 用户所有，每次安装 gem（Ruby 库）时，你都需要使用
sudo命令。这不仅麻烦，还存在安全风险。 - 版本陈旧与兼容性：Apple 更新系统 Ruby 的频率很低。而现代化的 gem 和 AI 相关的库通常依赖较新的 Ruby 特性（如 Ruby 3.1+ 的模式匹配改进）。
步骤 2：安装 RVM (Ruby Version Manager)
RVM 允许我们在同一台机器上安装、管理和切换多个版本的 Ruby。这对于同时维护传统项目和前沿 AI 应用至关重要。
#### 2.1 安装 GPG 公钥（推荐）
为了确保下载的安全性，我们最好先导入 RVM 的公钥。
# 导入 RVM 公钥以验证下载内容
command curl -sSL https://rvm.io/mpapis.asc | gpg --import -
#### 2.2 安装 RVM
接下来，我们将使用 curl 命令下载并执行 RVM 的安装脚本。
# 下载并安装稳定版的 RVM
\curl -sSL https://get.rvm.io | bash -s stable
# 加载 RVM 脚本
source ~/.rvm/scripts/rvm
步骤 3：安装并配置 Ruby
现在我们有了 RVM，接下来就可以用它来安装最新的 Ruby 了。
#### 3.1 查找并安装 Ruby
我们可以使用一条命令安装 Ruby，并将其设为默认版本。运行以下命令：
# 安装最新版本的 Ruby，并将其设为系统默认
rvm use ruby --install --default
工作原理：
这条命令告诉 RVM：“找到最新的稳定版 Ruby，如果还没安装就下载安装它，安装完后切换到这个版本，并把它设为终端打开时的默认版本。”
#### 3.2 验证安装
安装完毕后，我们再次检查版本：
# 再次检查 Ruby 版本
ruby -v
# 检查路径，确保不是 /usr/bin/ruby
which ruby
步骤 4：安装 Rails 框架及现代化工具链
Ruby 安装好了，接下来就是安装 Rails 框架本身。在 2026 年，我们不仅要安装 Rails，还要确保我们的开发环境是“云原生就绪”的。
#### 4.1 优化 Gem 安装速度
默认情况下，生成文档会耗费大量时间。我们可以创建一个 .gemrc 配置文件来永久关闭文档生成。
# 创建 gem 配置文件，禁用文档生成
echo "gem: --no-document" > ~/.gemrc
#### 4.2 安装 Rails 及 Node.js 依赖
现代 Rails 应用不可避免地要与 JavaScript 生态打交道。为了确保完整的开发体验，我们假设你已经安装了 Homebrew（macOS 上不可或缺的包管理器）。让我们确保 Node.js 也已就绪，因为 Rails 默认的 Importmap 或 esbuild 需要它。
# 安装 Node.js (如果尚未安装)
brew install node
# 安装 Rails 及其依赖
gem install rails
步骤 5：实战——运行你的第一个 Rails 应用
光说不练假把式。为了确保我们的环境真的可以工作，让我们创建一个测试应用并运行它。
#### 5.1 创建应用目录
首先，在你的 Mac 上找一个你喜欢的位置，在终端中执行以下命令：
# 创建一个用于存放实验项目的文件夹
mkdir trial-app
# 进入该文件夹
cd trial-app/
#### 5.2 生成新应用
接下来，我们使用 Rails 生成器来创建一个新的应用骨架。注意：在 2026 年的视角下，我们可以利用 Rails 7+ 引入的 INLINECODEc6eb123a 或 INLINECODE82c171b8 等选项快速配置前端。
# 创建一个新的 Rails 应用名为 trialapp
# 这将创建该目录并生成所有必要的文件和目录结构
rails new trialapp
#### 5.3 启动服务器
应用创建完成后，我们需要进入应用目录并启动 Web 服务器。Rails 默认使用 Puma 作为开发服务器。
# 进入应用目录
cd trialapp
# 启动 Rails 服务器
rails server
#### 5.4 在浏览器中访问
现在，打开 Safari 或 Chrome，在地址栏输入 http://localhost:3000。如果一切顺利，你应该能看到 Rails 的默认欢迎页面。
2026 进阶：AI 辅助开发与环境配置
仅仅搭建好环境是不够的。在 2026 年，我们还需要将我们的环境配置为“AI 友好型”。这意味着我们的代码结构和配置需要适应 AI 编码助手（如 Cursor、Copilot 或 Windsurf）的工作流。
#### 6.1 配置现代化的 Git 钩子
AI 辅助开发产生的大量代码变更需要严格的审查。我们建议在项目初始化时配置好 pre-commit 钩子。在 INLINECODE378ee40f 目录下，我们可以使用 INLINECODE2cbdea1d 或 lefthook。
让我们以 INLINECODE9950da65 为例，看看如何将其集成到我们的 Rails 流程中。首先，修改 INLINECODEff6ecfea，添加开发依赖：
# 在 Gemfile 中添加
group :development do
gem ‘overcommit‘, require: false
end
然后运行安装：
bundle install
overcommit --install
为什么要这么做？
当我们在 AI 的辅助下快速编写代码时，我们可能会忽略格式或引入简单的语法错误。通过配置 .overcommit.yml，我们可以在提交代码前自动运行 RuboCop（代码风格检查）和 Brakeman（安全扫描）。这利用了机器的严谨性来弥补 AI 有时可能出现的“幻觉”或疏忽，形成“人 + AI + 自动化工具”的高效三角组合。
#### 6.2 容器化开发：Docker 的初步考虑
虽然本地安装 Ruby 是学习 Rails 的必经之路，但在 2026 年，我们几乎不可避免地会接触到容器化。为了避免“在我机器上能跑”的问题，并方便后续部署到 Fly.io 或 Railway 等现代平台，我们建议在项目根目录创建一个简单的 Dockerfile。
这并不是强制要求现在就使用 Docker 运行项目，但编写 Dockerfile 有助于我们理解应用程序的依赖关系。以下是一个适合开发环境的 Dockerfile 示例：
# 使用官方的 Ruby 镜像作为基础镜像
FROM ruby:3.2
# 安装 Node.js 和 Yarn (Rails 7+ 需要)
RUN apt-get update -qq && apt-get install -y nodejs npm
# 设置工作目录
WORKDIR /myapp
# 复制 Gemfile 和 Gemfile.lock
COPY Gemfile Gemfile.lock ./
# 安装依赖
RUN bundle install
# 复制项目文件
COPY . .
# 预编译资产 (可选)
# RUN bundle exec rake assets:precompile
# 启动服务器
CMD ["rails", "server", "-b", "0.0.0.0"]
实践建议：
你可以尝试运行 docker build -t trialapp . 来构建这个镜像。即使你目前选择在本地运行 Rails，理解这一步也能让你明白生产环境与开发环境的边界在哪里。
总结与最佳实践
在这次探索中，我们不仅安装了软件，更重要的是建立了一个健康的开发心态。我们避开了系统 Ruby 的陷阱，使用了 RVM 来隔离不同项目的依赖，并通过配置 .gemrc 提升了效率。更重要的是，我们引入了 AI 时代需要的代码审查工具和容器化思维。
关键要点回顾：
- 不要使用系统 Ruby：始终保持系统环境的纯净，使用 RVM 或 rbenv 来管理开发环境。
- 版本隔离：利用 RVM 为不同的项目创建不同的 gemset。
- 拥抱 AI 工具：配置好 Git 钩子和代码检查工具，让它们成为你编写 AI 生成代码的安全网。
- 验证每一步：安装完任何软件后，使用
-v参数进行验证是排查问题的黄金法则。
下一步建议：
既然你的环境已经就绪，下一步你可以尝试：
- 使用 Cursor 或 VS Code + Copilot 打开你的 INLINECODE5c3e1333 项目，尝试让 AI “解释 INLINECODEbe8435f5 文件的作用”。
- 学习如何使用
scaffold命令快速生成一个带数据库 CRUD 功能的博客应用，然后尝试用 AI 辅助编写一个复杂的查询。
祝你在 Ruby on Rails 的开发之旅中代码流畅，Bug 全消！在这个充满智能助手的时代，保持对底层原理的理解将是你最大的优势。