Nuxt.js入門：モダンなWebフロントエンド開発を始めよう！

1. Nuxt.jsとは何か？

Nuxt.js（ナクストジェイエス）は、人気のあるJavaScriptフレームワーク Vue.js をベースにして構築された、オープンソースのフレームワークです。Vue.js単体でも素晴らしいUIを構築できますが、Nuxtはそれをさらに拡張し、より効率的でパワフルなWebアプリケーション開発（特にサーバーサイドレンダリング(SSR)や静的サイト生成(SSG)など）を実現するための様々な機能を提供します。

簡単に言えば、NuxtはVue.jsを使った開発体験を向上させ、複雑な設定や定型的な作業を自動化してくれる「頼れる相棒」のような存在です。Vue.jsをベースにしているため、Vue.jsの知識があれば比較的スムーズに学習を始めることができます。

2022年11月にはメジャーバージョンであるNuxt 3が正式にリリースされ、Vue 3、Vite、Nitroといった最新技術を取り込み、パフォーマンスと開発者体験が大幅に向上しました。現在（2025年4月時点）では、Nuxt 3が主流となっており、活発に開発が進められています。Nuxt 2の公式サポートは2024年6月末に終了しました。

3. Nuxt 3 のハイライト

Nuxt 3は、Nuxt 2から多くの点で進化しています。特に注目すべき点をいくつか挙げます。

• Vue 3 サポート: Composition APIやTeleport、Suspenseなど、Vue 3の新機能をフル活用できます。特にComposition APIは、ロジックの再利用性やコードの見通しを大幅に向上させます。
• Viteによる高速な開発体験: 開発サーバーの起動やHMRが非常に高速になり、ストレスのない開発が可能です。
• Nitroサーバーエンジン: より軽量で高速なサーバーを実現し、デプロイ先の選択肢が広がりました（Node.jsサーバー、サーバーレス、エッジなど）。APIルートの作成も簡単です。
• TypeScriptの統合強化: より堅牢な型サポートと自動型生成により、TypeScriptでの開発がさらに快適になりました。
• バンドルサイズの削減: よりモダンなフォーマットと最適化により、本番環境でのアプリケーションのパフォーマンスが向上しています。
• 自動インポートの強化: コンポーネントやComposableだけでなく、一部のVue APIなども自動インポートの対象となり、記述量が削減されます。

5. コアコンセプトの解説

Nuxtの主要な機能（ディレクトリ構造と関連するもの）について、もう少し詳しく見ていきましょう。

ファイルベースルーティング (pages/)

`pages/` ディレクトリに `.vue` ファイルを作成するだけで、自動的に対応するルートが生成されます。

• pages/index.vue → /
• pages/about.vue → /about
• pages/users/index.vue → /users
• pages/users/[id].vue → /users/:id (動的ルート)
• pages/products/[...slug].vue → /products/* (キャッチオールルート)

これにより、ルート設定ファイルを書く必要がなく、直感的にページを追加・管理できます。ページ間のナビゲーションには `` コンポーネントを使用します。

<template>
  <nav>
    <NuxtLink to="/">ホーム</NuxtLink>
    <NuxtLink to="/about">アバウト</NuxtLink>
    <NuxtLink :to="`/users/${userId}`">ユーザーページ</NuxtLink>
  </nav>
</template>

<script setup>
const userId = '123';
</script>

自動インポート (components/, composables/)

`components/` に配置したコンポーネントは、`.vue` ファイル内で直接タグとして使用できます。ネストしたディレクトリ構造もサポートされます（例: `components/common/Button.vue` は `` として利用可能）。

同様に、`composables/` に配置した Composition API 関数（例: `composables/useCounter.ts`）は、`script setup` 内で `import` なしに `useCounter()` のように呼び出せます。

<!-- pages/index.vue -->
<template>
  <div>
    <h1>ホームページ</h1>
    <!-- components/TheHeader.vue を自動インポート -->
    <TheHeader />
    <p>カウンター: {{ count }}</p>
    <button @click="increment">+1</button>
  </div>
</template>

<script setup>
// composables/useCounter.ts から自動インポート
const { count, increment } = useCounter();
</script>

// composables/useCounter.ts
import { ref } from 'vue'

export const useCounter = () => {
  const count = ref(0)
  const increment = () => count.value++
  return { count, increment }
}

レイアウト (layouts/)

アプリケーション全体で共通のヘッダーやフッターなどを適用したい場合、`layouts/` ディレクトリを使います。`layouts/default.vue` がデフォルトのレイアウトとして適用されます。特定のページに異なるレイアウトを適用することも可能です。レイアウトファイル内では `` を使ってページコンポーネントの内容を表示します。

<!-- layouts/default.vue -->
<template>
  <div>
    <header class="navbar is-primary">
      <!-- ヘッダーの内容 -->
      マイアプリ
    </header>
    <main class="section">
      <slot /> <!-- ここにページの内容が挿入される -->
    </main>
    <footer class="footer">
      <!-- フッターの内容 -->
       2025 アプリ名
    </footer>
  </div>
</template>

データフェッチング (useFetch, useAsyncData)

コンポーネントの `script setup` 内でサーバーサイド/クライアントサイド両方で動作する非同期データを取得するために、`useFetch` や `useAsyncData` を使用します。これらはSSR時にもデータを取得し、レンダリングされたHTMLに含めることができます。

<!-- pages/posts/[id].vue -->
<template>
  <div v-if="pending">読み込み中...</div>
  <div v-else-if="error">エラーが発生しました: {{ error.message }}</div>
  <article v-else>
    <h1>{{ post.title }}</h1>
    <p>{{ post.body }}</p>
  </article>
</template>

<script setup>
const route = useRoute();
const postId = route.params.id;

// useFetch を使ってAPIからデータを取得
// 第1引数はユニークなキー (通常はURL)、第2引数はフェッチ関数
const { data: post, pending, error } = await useFetch(
  () => `https://jsonplaceholder.typicode.com/posts/${postId}`
);

// useAsyncData はより複雑な非同期処理やキャッシュ制御が必要な場合に使用
// const { data: post, pending, error } = await useAsyncData(
//   `post-${postId}`,
//   () => $fetch(`https://jsonplaceholder.typicode.com/posts/${postId}`)
// );

if (error.value) {
  // エラーハンドリング (例: エラーページへリダイレクト)
  console.error('データ取得エラー:', error.value);
}
</script>

サーバー API ルート (server/api/)

`server/api/` ディレクトリ内にファイルを作成することで、APIエンドポイントを簡単に作成できます。ファイル名がそのままエンドポイントのパスになります（例: `server/api/hello.ts` は `/api/hello` エンドポイントになる）。Nitroサーバーエンジンによって処理され、バックエンドのロジックをNuxtプロジェクト内に実装できます。

// server/api/hello.ts
export default defineEventHandler((event) => {
  // event オブジェクトからリクエスト情報（クエリパラメータ、ボディなど）を取得可能
  // const query = getQuery(event);
  return {
    message: 'Hello from Nuxt API!'
  }
})

このAPIは、`useFetch(‘/api/hello’)` のようにしてフロントエンドから呼び出すことができます。

7. メリットとデメリット

Nuxt.jsを採用することには多くの利点がありますが、いくつかの考慮点も存在します。

メリット (Advantages)

• 開発効率の向上: ファイルベースルーティング、自動インポート、規約に基づくディレクトリ構造などにより、定型的な設定作業が大幅に削減され、開発者は機能実装に集中できます。
• パフォーマンス最適化: SSR/SSGによる高速な初期表示、自動コード分割、Nitroエンジンによる最適化など、パフォーマンス向上のための機能が組み込まれています。
• SEOへの強さ: SSRやSSGにより、検索エンジンのクローラーがコンテンツを容易にインデックスできるようになり、SEOに有利です。
• 構造化されたプロジェクト: 規約に基づいたディレクトリ構造により、プロジェクトの見通しが良くなり、チーム開発やメンテナンスが容易になります。
• 柔軟なレンダリングモード: アプリケーションの要件に合わせて、SSR, SSG, CSR, Hybrid, ESRといった多様なレンダリング戦略を選択できます。
• 豊富なエコシステム: 多くの公式・コミュニティモジュールが存在し、機能拡張が容易です。Vue.jsのエコシステムもそのまま活用できます。
• フルスタック開発能力: NitroエンジンとサーバーAPIルートにより、Nuxtプロジェクト内でバックエンドAPIも構築できます。
• 優れたTypeScriptサポート: 型安全な開発を強力に支援し、コード品質と保守性を高めます。

デメリット (Disadvantages)

• 学習コスト: Vue.jsの知識に加えて、Nuxt独自の規約や概念（ディレクトリ構造、ライフサイクル、データフェッチング方法など）を学ぶ必要があります。特にSSR/SSGの概念は初心者には少し難しく感じるかもしれません。
• 規約への依存: Nuxtは「規約大設定」(Convention over Configuration) の思想で作られているため、その規約に従うことが推奨されます。規約から外れたカスタマイズを行おうとすると、かえって複雑になる場合があります。
• フレームワークの抽象化: Nuxtが多くのことを自動で行ってくれる反面、内部で何が起こっているのかを完全に理解するのが難しくなることがあります。問題発生時のデバッグが複雑になる可能性もあります。
• プロジェクトの複雑性: 小規模なアプリケーションや単純なUIコンポーネントだけが必要な場合、Nuxtの機能は過剰かもしれません。その場合は、Vue.js単体やより軽量なソリューションの方が適している可能性があります。
• Nuxtのアップデート依存: フレームワークであるため、Nuxt自体のバージョンアップや仕様変更に追従していく必要があります。