Contents
3時間で完成！TODOアプリの作成を通じたRails学習ガイド
Ruby on Railsを学び始めたばかりの方にとって、「何から始めるべきか？」という疑問は大きなハードルになります。本記事では、「TODOアプリ」の開発を通して、環境構築から本番デプロイまでの流れをステップバイステップで解説します。3時間程度で完成できるミニプロジェクトに特化し、実践的な理解が得られるように設計しています。まずは「TODOアプリ」から始めてみましょう！コードを実際に書いてみることで理解が深まります。
Ruby on Railsの環境構築手順（Windows/Mac対応）
Ruby on Railsの学習には、まず開発環境の準備が必要です。OSごとに異なる手順があるため、自分の使用するPCに合わせて確認してください。最新版のツールを使うことで、将来的なトラブルを最小限に抑えられます。
Windowsでのインストール手順
WindowsでRailsを導入するには、RubyとRailsのバージョン管理が重要です。2025年現在、Ruby 3.1.x～3.2.xとRails 7.0.x～7.1.xが推奨されています。
以下はステップバイステップでの手順です：
- WSL（Windows Subsystem for Linux）の導入を強くおすすめします。Linux環境を構築するには、PowerShellで
wsl --installを実行してください。 - WSL内にUbuntuなどのLinuxディストリビューションをインストールし、
sudo apt update && sudo apt upgradeなどでシステムを最新化します。 sudo apt install ruby-full build-essentialコマンドでRubyと必要なツールをインストールします。- RubyGemsでRailsをインストールし、バージョンを確認します。例:
gem install rails -v 7.0.x→rails -vで実行可能か確認。
注意：DevKit-Mingw64はWindowsネイティブでのC拡張モジュールビルドに使用されますが、WSLを使うことでLinuxライクな環境を構築し、手順が簡潔になります。
Macでのインストール手順
MacではHomebrewやrbenvといったツールを使うことで、安定したRuby環境が構築できます。最新版のRubyとRailsを導入することで、開発効率が向上します。
以下はステップバイステップでの手順です：
- Homebrewをインストールし、
brew install rubyで最新版（例: Ruby 3.2.x）を取得します。 gem install rails -v 7.0.xでRailsをインストールします。バージョン確認はrails -vで行います。- rbenvやRVMなど、Rubyバージョン管理ツールを使用することで、複数プロジェクトでのバージョン切り替えが可能です。
| OS | Rubyバージョン（2025年推奨） | Railsバージョン（2025年推奨） | ツール |
|---|---|---|---|
| Windows | 3.1.x～3.2.x | 7.0.x～7.1.x | WSL, RubyGems |
| Mac | 3.2.x | 7.1.x | Homebrew, rbenv |
Railsアプリケーションの新規作成と起動
Rails環境が整ったら、実際にアプリケーションを作成します。rails newコマンドを用いることで、基本的なディレクトリ構造とファイルが自動生成されます。
rails newコマンドの使い方
ターミナルで以下のコマンドを実行してください：
|
1 2 3 |
rails new todo_app cd todo_app |
このコマンドにより、todo_appという名前のプロジェクトが作成され、以下のような構造になります：
app/：アプリケーションの本体（モデル、ビュー、コントローラー）config/：設定ファイル群db/：データベース関連lib/：ライブラリや補助コードpublic/：静的ファイル
注意：
rails new時にMySQLを指定する場合は、--database=mysqlオプションを使えるが、記事本文にMySQLの設定手順がないため、SQLiteやPostgreSQLを推奨します。
開発サーバーの起動手順
プロジェクトディレクトリに移動後、以下を実行して開発サーバーを起動します：
|
1 2 |
rails server |
ブラウザでhttp://localhost:3000を開くと、「Yay! You're on Rails!」というメッセージが表示されるはずです。これでRailsアプリケーションの基本構成は完成です。
MVC構造とデータベースマイグレーション
Ruby on Railsでは、MVC（モデル・ビュー・コントローラー）の設計思想に従って開発を行います。この構造を理解することで、コードの流れが把握しやすくなります。
モデル・ビュー・コントローラの役割
- モデル（Model）：データベースと関連する処理やビジネスロジックを担当します。
app/models/に配置されます。 - ビュー（View）：ユーザーに表示されるHTMLやテンプレートを管理します。
app/views/に配置されます。 - コントローラー（Controller）：モデルとビューの橋渡し役で、リクエストを受け取り、適切な処理を行います。
app/controllers/に配置されます。
例：TODOアプリでは、「Todoモデル」を作成し、そのデータを「todos_controller.rb」からコントロール、「index.html.erb」などで表示します。
マイグレーションファイルの作成方法
データベース設計にはマイグレーション（Migration）が用いられます。以下のようにコマンドでテーブルを作成できます：
|
1 2 |
rails generate migration CreateTodos title:string completed:boolean |
実行後、db/migrate/に生成されるファイルを編集し、upとdownメソッドを記述することで、データベースの構造を変更できます。マイグレーションは、開発・テスト・本番環境間で一貫した構造を保つための必須技術です。
ルーティング設定とHTMLテンプレート作成
Railsでは、URLとコントローラーの関係をconfig/routes.rbで定義します。このファイルを編集することで、ユーザーがアクセスするパスを制御できます。
config/routes.rbの基本構文
routes.rbを開き、以下のようにルーティングを追加してください：
|
1 2 3 4 |
Rails.application.routes.draw do resources :todos end |
これで、「GET /todos」などのリクエストが自動的にTodosController#indexにルーティングされます。ルーティングの設定は、アプリケーションのナビゲーション設計に直結するため、慎重に行う必要があります。
ビューファイルの作成手順
ビューのファイルを作成するには、app/views/todos/ディレクトリ内にHTMLテンプレートを配置します。以下は、index.html.erbの例です：
|
1 2 3 4 5 6 7 |
<h1>TODO一覧</h1> <ul> <% @todos.each do |todo| %> <li><%= todo.title %> <%= todo.completed ? '✓' : '✗' %></li> <% end %> </ul> |
ERB（Embedded Ruby）を使用することで、RubyのコードとHTMLを組み合わせて動的な表示が可能です。ビューはユーザーインターフェース設計の中心になります。
フォーム処理の実装とデプロイ準備
TODOアプリにフォームを追加し、データ入力機能を実装します。その後、本番環境に向けて必要なチェックリストを確認しましょう。
簡単な入力フォームの作成
new.html.erbを作成し、以下のようにフォームを書きます：
|
1 2 3 4 5 6 7 |
<%= form_with model: @todo do |f| %> <%= f.label :title %> <%= f.text_field :title %> <%= f.submit "追加" %> <% end %> |
このコードにより、新しいTODO項目の入力フォームが表示されます。form_withはRailsの標準的な形式で、POSTリクエストを自動生成します。
環境チェックリスト
デプロイ前に以下の点を確認してください：
- データベース接続：
config/database.ymlで本番環境用の設定が記載されているか - 環境変数管理：
ENV['SECRET_KEY_BASE']などのセキュリティ関連の値が設定されているか - Gemfile.lock：依存ライブラリのバージョンが一貫しているか
- JavaScript/CSSの最適化：
app/assetsに必要なファイルが配置されているか
ポイント：デプロイ環境でエラーが発生する前に、ローカルでのテストを徹底してください。
まとめ
本記事では、Ruby on Rails初心者が3時間で完成できるTODOアプリの作成手順をステップバイステップで解説しました。以下の要点を確認してください：
- 環境構築：Windows/Macに対応した最新版のインストール方法
- アプリケーション生成：
rails newコマンドと開発サーバーの起動手順 - MVC構造とマイグレーション：モデル、ビュー、コントローラーそれぞれの役割とデータベース設計方法
- ルーティングとテンプレート：URL設定とHTML表示の基本的な実装
- フォーム処理とデプロイ準備：ユーザー入力機能の実装と本番環境への移行に必要なチェックポイント
Railsは、素早く開発を進められるフレームワークです。実際にコードを書いてみることで理解が深まるため、ぜひ「TODOアプリ」から始めてみてください！