Rails scaffoldで学ぶCRUDの基本：初心者が押さえておきたいポイント

バックエンド開発•2025/2/6

Ruby on Rails

はじめに

Railsは初心者にとっても学びやすいWebアプリケーションフレームワークとして知られています。

その中でもscaffoldは、Railsが自動生成してくれる基本的なファイル群を通じて CRUD (Create, Read, Update, Delete)の流れを一気に理解できる仕組みとしてよく活用されます。

CRUDの一連の流れを短時間で形にできるため、まずは全体像を把握したい皆さんにとって大変助けになるでしょう。

とはいえ、scaffoldを使ってプロジェクトを始めると、なぜこのファイルが生成されるのか、どこを修正すればよいのかがわかりにくい面もあります。

そこで本記事では、Rails scaffold CRUD 初心者という方々が、実務イメージと照らし合わせながら基本を理解できるよう、具体的な例や手順を含めて解説していきます。

この記事を読むとわかること

scaffoldが自動生成するファイルの役割
RailsでのCRUD操作の概要と流れ
scaffoldを使ったプロジェクト立ち上げからビュー確認までの手順
実務と絡めたscaffoldの活用事例や注意点
scaffoldから一歩進んだカスタマイズや次のステップ

Rails scaffoldとは何か

Railsのscaffoldは、プロジェクト内部にあるモデル、コントローラ、ビューなどをまとめて自動生成してくれる仕組みです。

例えば、あるデータを登録・表示・編集・削除するための基本的なコードが一式そろった状態で作成されます。

初心者にとっては「どこに何を書けばよいのか」が漠然としているかもしれませんが、scaffoldを使えば、MVCアーキテクチャを自然と学ぶきっかけにもなります。

scaffoldが生成するファイルの構造

scaffoldコマンドを実行すると、以下のようにモデルやコントローラ、ビュー、マイグレーションファイルなどが一気に作成されます。


rails generate scaffold Book title:string author:string

このコマンドを例にすると、Bookという名前のモデルと、それを操作するためのコントローラ（books_controller.rb）、さらにビュー（index, show, new, edit などに対応するHTMLファイル）が自動で生成されます。

加えて、データベースの構造を管理するマイグレーションファイルも作られます。

これらが一気に作成されるので、データの新規作成・一覧表示・詳細表示・編集・削除といった一連の流れをコマンド1回で作り上げられるわけです。

CRUDの基本

CRUDは、データ管理の流れを表す最も基本的な概念としてよく使われます。

Create: 新規作成
Read: 読み取り（表示）
Update: 更新
Delete: 削除

Rails scaffoldを実行すると、このCRUDに対応するアクションがコントローラとビューに自動で反映され、すぐに動くひな形が完成します。

これを通じて、初心者でもとりあえず動くアプリを確認しながら学べるのがscaffoldの大きな利点です。

scaffoldを使った基本的な流れ

scaffoldを使い始めるには、大まかに以下の流れで進めます。

Railsプロジェクトの新規作成
scaffoldコマンドの実行
マイグレーションの実行
サーバーの起動
ブラウザで動作を確認

scaffoldコマンドの実行例

仮にBookというデータを管理する簡単なアプリを作る場合、以下のようなコマンドを実行します。


rails new myapp
cd myapp
rails generate scaffold Book title:string author:string
rails db:migrate
rails server

順を追って説明すると、最初のrails new myappがRailsプロジェクトの新規作成にあたります。

rails generate scaffold Book title:string author:stringを実行することで、CRUDに必要なファイル群が自動生成されます。

その直後にrails db:migrateを行うと、データベーステーブルが作成され、モデルと対応づけられます。

最後にrails serverでアプリケーションサーバーを起動し、ブラウザからhttp://localhost:3000/booksのようなURLにアクセスすれば、scaffoldが生成した一通りの画面を確認できます。

ルーティングとコントローラの関係

Railsでは、config/routes.rbにルーティングの設定が書き込まれます。

scaffoldを実行すると、このroutesファイルにresources :booksのような1行が追加され、CRUD操作すべてに対応したルーティングが自動設定されます。

このルーティング設定により、ブラウザのURLとコントローラ内のアクションとが紐づいて動作する仕組みになっています。

例えばGET /booksでindexアクション、POST /booksでcreateアクション、DELETE /books/:idでdestroyアクションが呼び出されるイメージです。

モデルとデータベースのマイグレーション

Railsにおいてモデルは、データの読み書きを扱う担当です。

scaffoldコマンドを実行すると、db/migrate/xxxx_create_books.rbのようなマイグレーションファイルが生成されます。

これは、データベーステーブルを作成したり、変更内容を記録したりするための設計書のような役割を果たします。

rails db:migrateを実行すると、この設計書どおりにテーブルが作られ、Rails側からはBookモデルを通じてデータを操作できるようになります。

scaffoldが自動生成するビュー構造

scaffoldが生成するビューは、app/views/books/の下に配置されます。

例として、index.html.erb、show.html.erb、new.html.erb、edit.html.erbなどがあります。

ビューで確認できるCRUDの操作

ブラウザでアクセスしてみると、以下のような画面が用意されているはずです。

1. 一覧表示 (index.html.erb)

Bookモデルの全データを表形式で一覧表示する画面です。
新規作成画面へのリンクも用意されています。

2. 詳細表示 (show.html.erb)

選択したBookデータの詳細内容が表示されます。
編集画面へのリンクもあり、そこからデータを更新できます。

3. 新規作成 (new.html.erb)

新たなBookデータを入力するためのフォームが設置されています。
フォームを送信すると、createアクションが呼ばれ、DBにデータが保存されます。

4. 編集画面 (edit.html.erb)

既存のBookデータを更新するためのフォームが表示されます。
フォーム送信でupdateアクションが実行され、DBの内容が書き換えられます。

これらの画面を行き来するだけで、Create, Read, Update, Deleteが成立していることがわかります。

レイアウトやスタイルの変更方法

scaffoldが生成する見た目はあくまで簡易的で、見栄えを意識したものではありません。

そのため、実務で使う際は レイアウトファイル (app/views/layouts/application.html.erb)やCSSファイルを調整し、自分たちのデザインに合わせてカスタマイズする必要があります。

ちなみに、1から全部自作するよりscaffoldでひな形を作ってから見た目を作り込む方が初心者にはわかりやすいことが多いでしょう。

scaffoldで学ぶMVCアーキテクチャ

Railsは MVC (Model, View, Controller)というアーキテクチャが特徴的です。

scaffoldを使うと、そのMVCの構造を一気に確認できるため、プログラミングを始めたばかりの方にとって把握しやすいというメリットがあります。

Modelの役割

Modelはデータの読み書きを担う部分です。

データベースから情報を取得したり、レコードを保存・削除したりするときにモデルを介して操作します。

Bookモデルであれば、Book.allやBook.find(id)などが基本的なメソッド呼び出しです。

Viewの役割

Viewはユーザーが目にする画面を担当します。

HTMLテンプレートにRubyのコードを埋め込む形で、xxx.html.erbという形式のファイルが作られます。

scaffoldでは、index、show、new、editなどの画面がそれぞれ別ファイルとして用意されます。

Controllerの役割

ControllerはModelとViewをつなぐ役割を果たします。

ユーザーがページへアクセスしたり、フォームを送信したりすると、このController内の特定アクションが呼び出されます。

アクションの中でModelを呼び出し、処理が終わったら結果をViewに渡すという流れです。

BooksControllerであれば、indexアクション、showアクション、createアクションなどが自動生成され、CRUDの流れに対応します。

実務におけるscaffoldの活用

scaffoldは初心者向けだけでなく、短期間で原型を作りたい場合など、実務でもある程度役立つ場面があります。

プロトタイプ開発や検証用途

新機能のプロトタイプを素早く確認したいときには、scaffoldによる自動生成が便利です。

とりあえずCRUDの枠組みを一瞬で作り出せるので、実装にかかる時間を大幅に減らせます。

大まかな仕様や画面遷移を早めに確かめたい場合、scaffoldで一気に骨格を作成してしまうのは有効です。

ただし、この段階で生成されたコードはあくまで“ざっくりと動く最低限の形”なので、ここから細かい仕様に合わせて修正することを忘れないようにしましょう。

学習用のサンプルとして使う

Railsのコード構成を理解するには、scaffoldによって作られたファイル群を隅々まで眺める方法が手っ取り早いです。

初心者がMVCの関連を掴むには最適な入口になります。

どのアクションがどのViewファイルに対応するのか、どうやってModelとやりとりしているのか、こういった点を自然に知ることができるでしょう。

大規模開発との違い

大規模なプロジェクトでは、scaffoldのままですべてを賄うケースは少ないです。

理由としては、実際のビジネスロジックや画面要件が複雑化し、scaffoldで生成される単純な構造だけでは対応しきれないことがあるからです。

また、テストコードや独自のルーティング構成など、より詳細な部分を調整したい場合もあります。

そのため、scaffoldはあくまで「最初のたたき台」と割り切るのが実務的といえます。

scaffoldのメリットと注意点

メリット：開発効率と学習

scaffoldの大きな魅力は、開発効率の高さと学習のしやすさにあります。

コマンド一発でCRUDに必要な一連の仕組みがそろう
コントローラやビュー、モデルの全体像を短時間で把握できる
短い時間で画面を作成できるので、フィードバックを得やすい

学習ステップとして「まず何がどこにあるかを知る」段階には、これ以上ないほど便利です。

注意点：カスタマイズや最適化

一方で、scaffoldで作られるコードは汎用的に作られたものです。

そのままだと不要なルーティングが含まれる場合や、セキュリティ上気をつけるべき点（ストロングパラメータなどの設定など）を調整する必要があります。

また、実際にはバリデーションをきちんと入れたり、見た目を整えたりといった作業が欠かせません。

scaffoldが生成した直後の状態はあくまで「とりあえず動く」段階ですので、そこからどう作り込むかが重要になります。

scaffoldで不要なルーティングやアクションを自動生成すると、意図しない範囲で情報が操作される可能性があります。不要なものはroutes.rbやコントローラから整理しましょう。

RailsでのCRUDアクションを理解する

CRUDはあらゆるWebアプリの基本と言われますが、Railsにおいてはscaffoldがその流れを具体的に示してくれます。

新規作成と保存の流れ

scaffoldでは、newアクションとcreateアクションがそれぞれ役割を持ちます。

1. newアクション

新規データ入力用のフォームを表示。
ここでユーザーがフォームに必要事項を入力します。

2. createアクション

フォームから送信されたデータを受け取り、Bookモデルに保存しようと試みます。
保存成功であれば一覧画面へリダイレクトし、失敗であれば再度new画面を表示。

このような仕組みがコントローラ（books_controller.rb）に組み込まれており、View（new.html.erb）との連携によって機能しています。

データの取得と表示

データを取得して表示する流れには、indexアクションとshowアクションが担う部分があります。

indexアクション

Bookの全レコードを取得してリスト表示。
@books = Book.allのような記述が一般的です。

showアクション

URLパラメータで渡されたidを元に単一のBookレコードを取得して表示。
@book = Book.find(params[:id])のような記述が見られます。

更新と削除で気をつけたいポイント

既存データの更新にはeditアクションとupdateアクションがペアになります。

editアクション

更新対象のBookレコードを取得し、フォームを表示。

updateアクション

フォームから送信された内容を使ってBookレコードを更新。

一方、削除はdestroyアクションが担当し、該当レコードを削除後、一覧画面などにリダイレクトします。

これらの操作を行ううえで注意すべきなのは、ストロングパラメータによる安全管理や、存在しないidを指定された場合の処理などです。

scaffoldでも最低限の設定は行われていますが、細かい要件に合わせたカスタマイズが必要になることが多いでしょう。

scaffoldから次のステップへ

scaffoldが用意してくれたコードをベースに、実務に近づけるにはさまざまな拡張やカスタマイズを行います。

バリデーションの追加

モデルにバリデーションを追加しないと、空のタイトルや不正な値なども保存されてしまいます。

たとえば、Bookモデルに以下のようなバリデーションを入れると、タイトルの必須入力をチェックできるようになります。


class Book < ApplicationRecord
  validates :title, presence: true
end

これにより、タイトルが入力されていない場合はエラーとなり、データが保存されません。

ルーティングやコントローラの整理

scaffoldが自動生成したコードには、アプリの利用状況によっては不要なルーティングやアクションが混在していることがあります。

その場合、config/routes.rbを編集し、resources :books, only: [:index, :show]のように必要なアクションだけを指定する書き方も有効です。

また、BooksController内にある処理をbefore_actionでまとめたり、別のモジュールに切り出したりと、規模に合わせた整理を進めると良いでしょう。

Viewの拡張

初期生成されたViewは最低限の機能を持つフォームやテーブルレイアウトなので、見た目を整えるためにHTMLやCSS、JavaScriptを追加することが多いです。

必要に応じて パーシャル (_partial.html.erb)を作り、複数画面で共通化できる部分を抜き出すと、保守性が向上します。

また、タブ切り替えやモーダルなどのUI要素を導入したい場合、JavaScriptを連携させる方法も考えましょう。

まとめ

Railsのscaffold機能は、初心者がMVCの全体像やCRUDの基本を理解するための強力な手段となります。

コマンドを一つ実行するだけで、データベーステーブルの生成からコントローラ、ビューの雛形まで整い、すぐにブラウザで動作を確認できます。

ただし、実務で使うには以下のようなポイントを意識する必要があります。

不要なルーティングやアクションを整理する
バリデーションやセキュリティ面（ストロングパラメータなど）を見直す
見た目（ビュー）をカスタマイズし、ユーザビリティを高める

scaffoldは「とりあえず動くもの」を手早く得られる便利な仕組みです。

最初からすべてを手打ちするのは大変ですが、scaffoldで全体像を把握しつつ、必要な箇所を自分なりに改良していくと、Railsの理解が深まるのではないでしょうか。

それでは、皆さんもCRUDの流れをスムーズに体感してみてください。