需依次安装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
