6 环境搭建之创建空Rails项目

在成功配置开发环境后，接下来的步骤是创建一个空的Rails项目。这一过程将基于上章中配置好的环境，通过创建一个新的Rails应用程序来验证我们的开发环境设置是否正确。

创建空Rails项目

在终端中执行以下命令来创建一个新的Rails项目：

rails new my_first_app

这里的 my_first_app 是你新项目的名称。执行此命令时，Rails会自动为你创建一个新的项目目录，并生成一系列文件和目录结构。

命令参数

Rails的new命令有许多可用的选项，常用的参数包括：

• --database: 指定你要使用的数据库类型（例如 mysql, postgresql, sqlite3）。
• --skip-test: 跳过测试框架的生成。
• --api: 创建一个API-only应用。

例如，如果你想使用PostgreSQL数据库，可以执行以下命令：

rails new my_first_app --database=postgresql

目录结构

生成项目后，可以进入到新创建的目录并查看其结构：

cd my_first_app

一个基本的Rails项目的目录结构会如下所示：

my_first_app/
├── app/
│   ├── assets/
│   ├── controllers/
│   ├── helpers/
│   ├── javascript/
│   ├── jobs/
│   ├── mailers/
│   ├── models/
│   └── views/
├── bin/
├── config/
├── db/
├── lib/
├── log/
├── public/
├── test/
├── tmp/
└── vendor/

• app/: 存放应用的主要代码，包含模型、控制器、视图等。
• config/: 处理配置文件，Rails的路由和设置。
• db/: 数据库相关的文件，例如迁移文件。
• public/: 可公开访问的文件。
• log/: 存放日志文件。

每个目录都有其特定的责任，确保了解每个部分的作用对于后续开发至关重要。

启动Rails服务器

接下来，用以下命令启动Rails服务器，确保一切已正确搭建：

bin/rails server

成功启动后，终端中会出现如下信息：

=> Booting Puma
=> Rails 7.x.x application starting in development
=> Run `bin/rails server --help` for more startup options

打开浏览器，访问 http://localhost:3000，如果看到Welcome aboard的页面，恭喜你，你已经成功创建了一个空的Rails项目。

常见问题

在创建空项目或启动服务器时，可能会遇到以下常见问题：

1. 未找到Rails命令：

   • 请确保已经在终端中安装了Rails，可以通过 gem install rails 来安装最新版本。

2. 数据库连接错误：

   • 确保所选数据库已安装并且正确配置。

3. 权限问题：

   • 在某些情况下，你可能需要使用sudo权限来运行命令，或者检查相关文件和目录的权限设置。

总结

在本章中，我们完成了空Rails项目的创建并成功启动了开发服务器。接下来，我们将进入到第三章，开始创建我们的第一个Rails应用，通过生成控制器和视图来更深入地了解Rails的工作机制。在这之前，确保你对本章的流程有透彻的理解，这将帮助你在后续的学习中更为顺利。