Ruby on Rails 的安装与配置详解

Ruby on Rails，简称 Rails，是一个功能强大的 Web 应用程序框架，以其简洁优雅的语法和高效的开发速度而闻名。本文将详细介绍如何在不同操作系统上安装和配置 Ruby on Rails 开发环境，涵盖各种可能的场景和问题，帮助你顺利踏上 Rails 开发之旅。

一、安装前的准备

在正式安装 Rails 之前，我们需要先准备好一些必要的工具和环境。这些工具在不同操作系统上略有不同，下面分别进行说明：

1. macOS

macOS 系统预装了 Ruby，但版本可能较旧。建议使用版本管理器来安装和管理多个 Ruby 版本，例如 rbenv 或 RVM。

• 使用 rbenv:

bash
brew install rbenv ruby-build
echo 'eval "$(rbenv init -)"' >> ~/.zshrc # 或 ~/.bash_profile，取决于你的 shell
source ~/.zshrc # 或 ~/.bash_profile
rbenv install <ruby-version> # 例如：rbenv install 3.2.2
rbenv global <ruby-version>

• 使用 RVM:

bash
\curl -sSL https://get.rvm.io | bash -s stable
source ~/.bashrc # 或 ~/.zshrc
rvm install <ruby-version>
rvm use <ruby-version> --default

2. Linux (Ubuntu/Debian)

“`bash
sudo apt update
sudo apt install git-core zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

安装 rbenv (推荐)

sudo apt-get install -y autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo ‘export PATH=”$HOME/.rbenv/bin:$PATH”‘ >> ~/.bashrc
echo ‘eval “$(rbenv init -)”‘ >> ~/.bashrc
source ~/.bashrc
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install
rbenv global
“`

3. Windows

在 Windows 上，建议使用 RubyInstaller 来安装 Ruby。下载并安装 RubyInstaller 后，确保将 Ruby 的 bin 目录添加到环境变量 PATH 中。

• 安装 RubyInstaller:

下载 RubyInstaller for Windows，选择合适的版本进行安装。安装过程中，勾选 “Add Ruby executables to your PATH” 选项。

• 安装 Development Kit:

下载与 Ruby 版本对应的 DevKit，解压到一个目录，例如 C:\DevKit。

bash
cd C:\DevKit
ruby dk.rb init
ruby dk.rb install

二、安装 Ruby on Rails

安装好 Ruby 和相应的工具后，就可以开始安装 Rails 了。使用 gem 命令即可轻松完成安装：

bash
gem install rails -v <rails-version> # 例如：gem install rails -v 7.0.4

如果安装速度较慢，可以考虑使用国内的镜像源：

“`bash
gem sources –add https://gems.ruby-china.com/ –remove https://rubygems.org/
gem sources -l

确认只有 gems.ruby-china.com

“`

三、创建新的 Rails 项目

安装完成后，可以使用 rails new 命令创建一个新的 Rails 项目：

bash
rails new <project-name> # 例如：rails new my_app

这将会创建一个名为 <project-name> 的目录，其中包含了 Rails 项目的完整结构。

四、配置数据库

Rails 默认使用 SQLite 数据库。如果需要使用其他数据库，例如 MySQL 或 PostgreSQL，需要修改 config/database.yml 文件中的配置。

• MySQL:

“`yaml
default: &default
adapter: mysql2
encoding: utf8mb4
pool: <%= ENV.fetch(“RAILS_MAX_THREADS”) { 5 } %>
username: root # 替换为你的 MySQL 用户名
password: password # 替换为你的 MySQL 密码
host: localhost

development:
<<: *default
database: _development

test:
<<: *default
database: _test

production:
<<: *default
database: _production
“`

• PostgreSQL:

“`yaml
default: &default
adapter: postgresql
encoding: unicode
pool: <%= ENV.fetch(“RAILS_MAX_THREADS”) { 5 } %>
username: postgres # 替换为你的 PostgreSQL 用户名
password: password # 替换为你的 PostgreSQL 密码
host: localhost

development:
<<: *default
database: _development

test:
<<: *default
database: _test

production:
<<: *default
database: _production
“`

配置完成后，需要安装相应的数据库适配器：

“`bash

MySQL

gem install mysql2

PostgreSQL

gem install pg
“`

五、启动 Rails 服务器

进入项目目录，使用以下命令启动 Rails 服务器：

bash
cd <project-name>
rails server

默认情况下，服务器将在 http://localhost:3000 上运行。

六、常见问题及解决方法

• gem install 速度慢: 使用国内镜像源，如上文所述。

• 依赖库安装失败: 检查网络连接，或者尝试使用 sudo 权限安装。

• 数据库连接错误: 确认数据库已正确安装并运行，用户名和密码正确，config/database.yml 文件中的配置也正确。

• 端口冲突: 如果端口 3000 已被占用，可以使用 -p 参数指定其他端口，例如 rails server -p 3001。

• macOS 安装 sqlite3 问题： 尝试使用 brew install sqlite 安装 sqlite3，然后重新安装 Rails。

七、其他配置

• JS 框架: Rails 默认支持 importmap，也可以选择使用 webpacker 或 esbuild 等其他前端构建工具。

• CSS 框架: Rails 默认支持 Tailwind CSS，也可以选择使用 Bootstrap 或其他 CSS 框架。

八、总结

本文详细介绍了 Ruby on Rails 的安装和配置过程，涵盖了不同操作系统和常见问题的解决方法。希望这篇文章能够帮助你顺利搭建 Rails 开发环境，开始你的 Rails 开发之旅。 记住，持续学习和实践是掌握 Rails 的关键。 多尝试不同的配置，深入理解 Rails 的运作机制，才能构建出更加优秀的 Web 应用程序。 祝你学习顺利！