rails new コマンドによるアプリ作成

rails new コマンドとは

rails new アプリ名 は、指定したディレクトリに Rails アプリの骨組み（Gemfile、ディレクトリ構造、各種設定ファイルなど）を自動生成し、Bundler で依存 gem をインストールまで行う “プロジェクトスキャフォールディング” ツールです。Rails 8 系の --help 出力を見ると、数十種類のオプションで生成内容を細かく制御できることがわかります。gist.github.com

---

1. 事前準備

※ バージョン管理には rbenv / asdf 等を推奨。

---

2. 基本構文

bash
rails new <APP_PATH> [オプション]

• <APP_PATH> にディレクトリ名、または . を指定するとカレントディレクトリに生成

• 生成後に cd <APP_PATH> && bin/rails server で動作確認

---

3. 代表的なオプション分類

---

4. 生成例

---

5. 生成後の初期タスク

1. DB 作成（Active Record 利用時）

   bash
   bin/rails db:create
   

2. 初期コミット

   bash
   git init && git add . && git commit -m "Initial Rails app"
   

3. 不要ライブラリの整理（Gemfile や package.json）

4. 環境ごとの設定（config/environments/*）

---

6. カスタムテンプレート & .railsrc

• -m https://…/template.rb で独自 generator スクリプトを適用

• 毎回同じオプションを使う場合は ホームディレクトリの .railsrc に書いておけばコマンドが短くなる discuss.rubyonrails.org

bash
# ~/.railsrc
--database=postgresql
--css=tailwind
--javascript=esbuild

---

7. よくある落とし穴とベストプラクティス

1. オプション重複 – --minimal と --api は併用不可。API で最小構成にしたい場合は --api のみで十分。

2. Windows 環境 – MSYS2／WSL を利用しないとネイティブ gem のビルドで躓きやすい。

3. バージョン固定 – 複数案件を扱う場合は bundle init → gem 'rails', 'x.y.z' でバージョンをロック。

4. Docker 開発 – --skip-docker を省けば Dockerfile と bin/docker-entrypoint が自動生成される（Rails 8 以降）。gist.github.com

---

まとめ

rails new は 使い方次第でフルスタックから API 専用、極小フットプリント まで作り分けられます。まずは必要最小限オプションで生成し、あとから generator や template、.railsrc を活用して自分の標準構成を確立すると開発体験が向上します。