Ruby on Rails开发环境搭建指南

需依次安装rbenv、Ruby 3.2.2、Rails 7.1.x、Node.js及Yarn，并验证各组件协同工作正常。

如果您希望在本地计算机上搭建一个可用于Web开发的Ruby on Rails开发环境，则需要依次安装Ruby解释器、Rails框架及其依赖工具。以下是完成该任务的具体步骤：

一、安装Ruby版本管理工具rbenv

rbenv用于管理多个Ruby版本，避免系统级Ruby被污染，并支持项目级Ruby版本切换。它比RVM更轻量，与Shell集成良好，适合开发环境初始化。

1、打开终端，执行命令下载rbenv安装脚本：curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash

2、将rbenv添加到shell配置文件中（以bash为例）：echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc

3、启用rbenv自动加载功能：echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc

4、重新加载配置文件：source ~/.bashrc

5、验证安装是否成功：rbenv --version

二、通过rbenv安装指定Ruby版本

使用rbenv安装稳定版Ruby（如3.2.2），确保兼容最新Rails版本并获得安全更新支持。安装过程会自动编译源码并配置可执行路径。

1、列出所有可用Ruby版本：rbenv install --list | grep "^[0-9]" | tail -10

2、安装Ruby 3.2.2：rbenv install 3.2.2

3、设置全局Ruby版本为3.2.2：rbenv global 3.2.2

4、验证当前Ruby版本：ruby -v

5、确认Gem包管理器已就绪：gem -v

三、安装Rails框架及基础依赖

Rails作为Ruby的Web应用框架，需通过Gem包管理器安装。同时需确保系统具备编译原生扩展所需的构建工具，如make、gcc和libssl-dev等。

1、升级Gem至最新稳定版：gem update --system

2、安装Bundler（依赖管理工具）：gem install bundler

3、安装Rails 7.1.x主版本：gem install rails -v "~> 7.1.0"

4、检查Rails是否正确注册：rails -v

5、验证新项目创建能力：rails new test_app --skip-bundle && cd test_app && ls -A | head -5

四、配置Node.js与Yarn作为JavaScript运行时

Rails 7默认使用Import Maps或esbuild处理前端资源，但仍需Node.js提供基础JS执行环境；Yarn则用于管理npm包依赖，尤其在启用jsbundling-rails时必需。

1、通过系统包管理器安装Node.js（Ubuntu示例）：sudo apt update && sudo apt install -y nodejs npm

2、验证Node.js版本（需≥18.0.0）：node -v

3、安装Yarn经典版：npm install -g yarn

4、验证Yarn是否可用：yarn --version

5、在新建Rails项目中启用Yarn支持：rails new myapp --javascript=esbuild --css=tailwind

五、验证完整开发环境可用性

通过生成最小可行Rails应用并启动开发服务器，确认Ruby、Rails、Node.js、数据库驱动等组件协同工作正常，无缺失依赖或权限错误。

1、创建空白Rails项目：rails new hello_rails && cd hello_rails

2、安装项目级依赖：bundle install

3、执行数据库初始化（跳过实际建库，仅验证连接器）：bin/rails db:prepare 2>/dev/null || true

4、启动开发服务器：bin/rails server -p 3001

5、在另一终端中测试HTTP响应：curl -sI http://localhost:3001 | head -1