Next.jsで学ぶReact講座 90日コース | Next.js基礎 - Day 36:Next.jsとは

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 36:Next.jsとは何かを理解して、最初のプロジェクトを作る

Day 36では、Reactの次の段階としてNext.jsを学び始めます。今日は、Next.jsが何なのか、Reactとどう違うのか、フレームワークとは何か、そして実際にNext.jsプロジェクトを作るところまでを、初心者向けに一歩ずつ進めます。 (🔗 nextjs.org)

Next.jsの学習で最も大切なのは、「Reactの代わりにNext.jsを使う」のではなく、「ReactでUIを作り、Next.jsでアプリ全体を組み立てる」と理解することです。Next.js公式は、Next.jsをReactフレームワークと説明しており、ReactコンポーネントでUIを作り、Next.jsが追加機能や最適化を担うと案内しています。 (🔗 nextjs.org)

Day 36で学ぶこと

今日は次の4つを順番に理解します。 (🔗 nextjs.org)

  • Next.jsとは何か。
  • ReactとNext.jsの違い。
  • フレームワークとは何か。
  • Next.jsプロジェクトの基本構成と作成手順。

Next.jsとは

Next.jsは、Reactを土台にしてWebアプリを作るためのフレームワークです。公式ドキュメントでは、Next.jsは「React framework for building full-stack web applications」と説明されており、ReactコンポーネントでUIを作りつつ、追加の機能や最適化を提供するとされています。 (🔗 nextjs.org)

ここでいう「追加の機能」には、ルーティング、データ取得、レンダリング、キャッシュ、ナビゲーション最適化などが含まれます。App Routerのドキュメントでも、Next.jsはファイルベースのルーティングやServer Componentsなど、React単体だけでは用意されないアプリ全体の仕組みを提供しています。 (🔗 nextjs.org)

初心者のうちは、Next.jsを「Reactで部品を作り、その部品を使って本格的なアプリを組み立てやすくする枠組み」と考えると理解しやすいです。ReactがUIの中心で、Next.jsがその周りの実用的な仕組みを整えてくれる、というイメージです。 (🔗 nextjs.org)

Reactとの違い

Reactは、ユーザーインターフェースを表示するためのJavaScriptライブラリです。React公式は、ReactをUIをレンダリングするためのライブラリと説明しています。 (🔗 react.dev)

一方で、React公式は新しいReactアプリを始めるとき、推奨されるフレームワークの利用を案内しています。さらに、ゼロからReactアプリを作る場合は、ルーティングやデータ取得などの一般的な仕組みを自分で選んで構築する必要があるとも説明しています。 (🔗 react.dev)

つまり違いを簡単に言うと、次のようになります。 (🔗 nextjs.org)

  • React:UIを作るためのライブラリです。
  • Next.js:Reactを使って、ルーティングや構成、最適化まで含めてアプリ全体を作るためのフレームワークです。

この違いを実感するには、例で考えると分かりやすいです。たとえばボタンやフォームや一覧画面の見た目はReactで作れますが、「URLごとにページを分ける」「画像やフォントを最適化する」「サーバー側の仕組みも使う」といった部分は、Next.jsが強い領域です。 (🔗 nextjs.org)

フレームワークとは

フレームワークとは、アプリ開発でよく必要になる土台やルールや仕組みを、あらかじめまとめて提供してくれるものです。Next.jsの学習ページでは、モダンなWebアプリにはUI、ルーティング、データ取得、レンダリング、統合、インフラ、パフォーマンス、スケーラビリティなど、複数の要素を考える必要があると説明されています。 (🔗 nextjs.org)

Reactだけで始めると、こうした仕組みを自分で選んで組み合わせる場面が増えます。React公式も、フレームワークを使わずに始める場合は、ルーティングやデータ取得などの一般的な問題に対する解決策を自分で用意する必要があると述べています。 (🔗 react.dev)

そのため初心者にとってフレームワークは、「自由を奪うもの」ではなく、「迷う場所を減らしてくれるもの」です。特に学習初期は、最初から全部を自分で決めるより、Next.jsの標準的な流れに乗って作るほうが理解しやすいです。 (🔗 nextjs.org)

Next.jsの現在の基本方針

現在のNext.js公式ドキュメントでは、App Routerが「Using App Router Features available in /app」として案内されており、インストール手順でもApp Routerが推奨されています。App Routerは、Reactの新しい機能であるServer Components、Suspense、Server Functionsなどを活用するルーターです。 (🔗 nextjs.org)

そのため、この講座でもDay 36以降は、基本的にappディレクトリを使うApp Router前提で学ぶのが自然です。古い教材ではpagesディレクトリが中心のことがありますが、今から始めるならまずappディレクトリの構成に慣れるのがおすすめです。 (🔗 nextjs.org)

Next.jsプロジェクト構成の基本

Next.js公式のプロジェクト構成ページでは、トップレベルの主なフォルダーとしてapp、pages、public、srcが案内されています。appはApp Router、publicは静的アセット、srcは任意のソース用フォルダーです。 (🔗 nextjs.org)

初心者が最初に覚えるべき主要ファイルとフォルダーは、次のとおりです。 (🔗 nextjs.org)

  • app/:ページやレイアウトを置く中心フォルダーです。
  • app/page.tsx:トップページです。
  • app/layout.tsx:共通レイアウトです。ルートレイアウトは必須で、htmlとbodyタグを含みます。
  • public/:画像などの静的ファイルを置きます。
  • package.json:依存関係やスクリプトを管理します。
  • next.config.js:Next.jsの設定ファイルです。
  • .env.local:ローカル環境変数を置くファイルで、公式はバージョン管理に含めないよう案内しています。

最低限の完成イメージ

my-first-next-app/
├── app/
│   ├── layout.tsx
│   ├── page.tsx
│   └── about/
│       └── page.tsx
├── public/
├── package.json
├── next.config.ts または next.config.js
└── tsconfig.json

この構成は、App Routerの基本形を学ぶには十分です。appの中にフォルダーを作ると、そのフォルダー名がURLの一部になります。たとえばapp/about/page.tsxを作ると、/aboutというページになります。 (🔗 nextjs.org)

実践の前に準備するもの

現行のApp Router公式インストールページでは、開発環境の最低条件としてNode.js 20.9以上が必要です。対応OSとしてmacOS、Windows(WSLを含む)、Linuxが案内されています。 (🔗 nextjs.org)

実際の作業前に、次のものを準備してください。 (🔗 nextjs.org)

  • Node.js。
  • ターミナル。
  • VS Codeなどのエディタ。

Node.jsの確認は、次のコマンドで行えます。

# Node.jsのバージョンを確認します
node -v

20.9以上でなければ、先にNode.jsを更新してから進めるほうが安全です。古いNode.jsでは、現在のNext.js作成手順と合わないことがあります。 (🔗 nextjs.org)

Step 1:Next.jsプロジェクトを作成する

Next.js公式では、新しいアプリを作る最も速い方法としてcreate-next-appの利用を案内しています。公式クイックスタートではpnpm create next-app@latest my-app --yesの例が掲載されています。 (🔗 nextjs.org)

ここでは、初心者でも確認しながら進めやすいように、対話式で作成する手順を使います。

# create-next-app を起動して新しいプロジェクトを作成します
npx create-next-app@latest

このCLIは、プロジェクト名やTypeScript、リンター、Tailwind CSS、src/ディレクトリ、App Router、import aliasなどを質問しながら設定できます。公式インストールページにも、カスタマイズ時の質問項目が案内されています。 (🔗 nextjs.org)

初心者向けのおすすめ回答

最初の学習では、次のように選ぶと進めやすいです。 (🔗 nextjs.org)

  • Project name:my-first-next-app
  • TypeScript:Yes
  • Linter:ESLint
  • React Compiler:Noでも可
  • Tailwind CSS:Noでも可
  • src/ directory:YesでもNoでも可
  • App Router:Yes
  • Import alias:Yesのまま@/*でも可

最初の学習では、Tailwind CSSをまだ使わないならNoでも十分です。見た目の学習を後で分けたい場合、最初はできるだけ構成をシンプルに保つと理解しやすくなります。これは講座としての学習上のおすすめであり、CLI自体はTailwindや各種設定を含めて自動構成できます。 (🔗 nextjs.org)

Step 2:プロジェクトへ移動して開発サーバーを起動する

プロジェクトの作成が終わったら、フォルダーへ移動して開発サーバーを起動します。公式ドキュメントでは、cd my-appしてから開発サーバーを起動し、localhost:3000へアクセスする流れが案内されています。 (🔗 nextjs.org)

# 作成したプロジェクトフォルダーへ移動します
cd my-first-next-app

# 開発サーバーを起動します
npm run dev

Next.jsのスクリプトとして、next devは開発サーバー、next buildは本番ビルド、next startは本番サーバー起動に使われます。現行のインストールページでは、Turbopackがデフォルトのバンドラーとして案内されています。 (🔗 nextjs.org)

起動後にブラウザーでhttp://localhost:3000を 開くと、初期画面が表示されます。表示された時点で、Next.jsプロジェクトの作成は成功です。 (🔗 nextjs.org)

Step 3:生成されたファイルを見る

作成直後の中身を全部理解する必要はありません。まずは、どこを見ればよいかだけを押さえます。 (🔗 nextjs.org)

  • app/page.tsx:トップページです。
  • app/layout.tsx:全ページ共通のレイアウトです。
  • public/:画像などを置きます。
  • package.json:実行スクリプトや依存関係が書かれています。
  • tsconfig.json:TypeScriptを有効にした場合の設定です。

ここで特に重要なのは、app/page.tsxとapp/layout.tsxです。Next.jsでは、appディレクトリ内のファイル配置がそのままルーティングの基礎になります。これはファイルシステムベースルーティングと呼ばれます。 (🔗 nextjs.org)

Step 4:app/page.tsxを書き換える

まずはトップページの中身を、自分の文章に変えてみます。app/page.tsxを開き、次のように書き換えてください。

// トップページを表示するコンポーネントです
export default function Page() {
  // 画面に見出しと説明を表示します
  return (
    <main>
      <h1>Next.js学習スタート</h1>
      <p>Day 36で最初のNext.jsプロジェクトを作成しました。</p>
    </main>
  );
}
TSX

Next.jsのレイアウトとページの基本例として、公式ドキュメントでもapp/page.tsxにReactコンポーネントをdefault exportする形が案内されています。 (🔗 nextjs.org)

保存すると、開発サーバー上の画面が自動更新されます。これで「ファイルを編集すると画面が変わる」という最初の成功体験が得られます。 (🔗 nextjs.org)

Step 5:app/layout.tsxを見る

次に、ルートレイアウトを確認します。App Routerでは、ルートレイアウトは必須で、htmlタグとbodyタグを含む必要があります。 (🔗 nextjs.org)

たとえば、次のような形です。

// アプリ全体の共通レイアウトです
export default function RootLayout({
  children,
}: {
  // 各ページの内容がここに入ります
  children: React.ReactNode;
}) {
  return (
    <html lang="ja">
      <body>
        {/* ここに各ページの内容が表示されます */}
        {children}
      </body>
    </html>
  );
}
TSX

childrenは、各ページの中身が差し込まれる場所です。初心者のうちは、「共通の外枠がlayout.tsx、ページごとの中身がpage.tsx」と理解すれば十分です。 (🔗 nextjs.org)

Step 6:2ページ目を作る

Next.jsの気持ちよさを理解するために、もう1ページ作ります。app/about/page.tsxを新しく作成してください。

// Aboutページを表示するコンポーネントです
export default function Page() {
  // /about にアクセスするとこの内容が表示されます
  return (
    <main>
      <h1>Aboutページ</h1>
      <p>このページは app/about/page.tsx から作られています。</p>
    </main>
  );
}
TSX

Next.jsでは、appの中にフォルダーを作り、その中にpage.tsxを置くと、対応するルートが作られます。たとえばapp/about/page.tsxは/aboutに対応します。 (🔗 nextjs.org)

ブラウザーで/aboutを開いて表示を確認してください。自分でルーター設定ファイルを書く前に、フォルダー構成からページが生まれる体験をしておくことが大切です。 (🔗 nextjs.org)

Step 7:プロジェクト構成を自分の言葉で説明できるようにする

ここまでで、最小構成のNext.jsプロジェクトは次のように理解できます。 (🔗 nextjs.org)

  • app/layout.tsx:全ページの共通外枠です。
  • app/page.tsx:トップページです。
  • app/about/page.tsx:Aboutページです。
  • public/:画像などの静的ファイル置き場です。
  • package.json:依存関係と実行コマンドです。

この説明が自分で言えるようになると、以後の学習で「今どこを編集しているのか」が分かりやすくなります。初心者のうちは、機能を増やす前に構造を声に出して整理すると、理解が定着しやすいです。

Reactだけの感覚で触ると混乱しやすい点

Next.jsを初めて使うと、Reactだけを学んできた人ほど次の点で混乱しやすいです。これらは学習初期に特に重要です。 (🔗 nextjs.org)

  • ページはコンポーネントでもある:ただし、どこに置くかでURLが決まります。
  • フォルダー構成が意味を持つ:名前だけでなく、ルーティングに直結します。
  • レイアウトは必須の役割を持つ:特にルートレイアウトは必要です。
  • Reactだけで完結しない:アプリ全体の構成をNext.jsが担います。

つまり、Reactの「部品を作る」発想に加えて、Next.jsでは「部品をどこに置くか」も同じくらい重要になります。

セキュリティと注意点

.envや.env.localは環境変数を置くためのファイルで、公式ドキュメントではバージョン管理に含めないよう案内されています。APIキーや秘密情報を学習中に試す場合でも、これらをGitへ公開しない習慣は最初から身につけておくべきです。 (🔗 nextjs.org)

学習初期の段階では、秘密鍵や本物のAPIキーを画面に直書きしない、公開リポジトリへ.env.localを含めない、という3点を特に意識してください。Next.jsを学ぶことと、秘密情報の扱いを雑にすることは別です。

よくあるつまずき

  • Node.jsのバージョンが古い:現行のApp Routerインストール要件はNode.js 20.9以上です。
  • app/layout.tsxがない:ルートレイアウトは必須です。
  • app/page.tsxを別の場所へ置いている:App Routerでは場所が重要です。
  • /aboutが開けない:app/about/page.tsxになっているか確認します。
  • 環境変数を公開してしまう:.env.localをバージョン管理へ含めないようにします。

これらの多くは、コードの中身よりも「構成」と「置き場所」が原因です。Next.jsの最初の壁は、Reactの文法ではなく、ファイル構成の理解であることが多いです。 (🔗 nextjs.org)

Day 36のチェックリスト

  • Next.jsがReactフレームワークだと説明できます。
  • ReactがUIライブラリ、Next.jsがアプリ全体の枠組みだと説明できます。
  • フレームワークが、よく使う仕組みをまとめて提供するものだと説明できます。
  • create-next-appで新しいプロジェクトを作れます。
  • npm run devで開発サーバーを起動できます。
  • app/page.tsxとapp/layout.tsxの役割を説明できます。
  • app/about/page.tsxを作って、/aboutを表示できます。

まとめ

Day 36では、Next.jsを「Reactを置き換えるもの」ではなく、「Reactを使って本格的なWebアプリを作るためのフレームワーク」として理解することが目標です。ReactでUIを作り、Next.jsでルーティングや構成や最適化を扱う、という役割分担が分かると、今後の学習が非常に進めやすくなります。 (🔗 nextjs.org)

今日の実践では、create-next-appでプロジェクトを作成し、app/page.tsxを書き換え、app/about/page.tsxを追加しました。ここまでできれば、次のDay 37以降でレイアウト、ナビゲーション、Server ComponentとClient Componentの理解へ自然につなげられます。 (🔗 nextjs.org)

タイトルとURLをコピーしました