※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。

Vite(ヴィート)は、Evan You(Vue.js作者)が開発したフロントエンドビルドツールです。2020年の登場以来、React・Vue・Svelte・Solid・Qwikなど主要フレームワークの公式テンプレートに採用され、今やフロントエンド開発の事実上の標準ビルドツールとなっています。2026年11月現在の最新版は v8.3.8(2026年11月11日リリース)で、2026年3月のVite 8.0では Rolldown(Rustベースの高速バンドラー)が統合され、ビルド速度が大幅に向上しました。

本記事では、Viteをまだ使ったことがない方から、v5・v6系から最新v8系への移行を検討している方まで役立つよう、仕組みから設定・プラグイン開発・最新機能まで実践コード付きで解説します。

広告・楽天アフィリエイト

プログラミング技術書

実践寄りの技術書・参考書を探す。

楽天ポイント還元

技術書を楽天で見る →

Viteとは|なぜ速いのか

従来のWebpackなどのビルドツールは、開発サーバー起動時にアプリ全体をバンドル(結合)してから提供していました。ファイル数が増えるほど起動が遅くなり、変更が全体のリバンドルを引き起こすという問題がありました。

Viteの公式ドキュメントによると、Viteは開発時に以下の2段階に処理を分けることで高速化を実現しています。

  • 依存関係の事前バンドル:node_modules内のパッケージ(CommonJS形式のものを含む)は起動時に一度だけ変換・キャッシュ。Vite 7まではesbuild、Vite 8からはRolldownが担当する
  • ソースコードはネイティブESMで配信:自分で書いたコードは変換せずブラウザのES Modulesとして直接配信。ブラウザが必要なファイルだけをオンデマンドで要求するため、起動・更新が一瞬

HMR(Hot Module Replacement)も同様に、変更されたモジュールのみを差分更新するため、ファイル数が増えても更新時間はほぼ一定です。

ツール 開発サーバー 本番ビルド 特徴
Vite 8 ネイティブESM + Rolldown Rolldown 高速・軽量・エコシステムが充実
Webpack 5 フルバンドル(遅い) Webpack 成熟・実績あり・設定複雑
Turbopack 差分更新(Rust) Turbopack Next.js専用・高速
Parcel 2 差分更新 SWC 設定ゼロ・自動検出

クイックスタート|プロジェクト作成

公式の「Getting Started」に従ってプロジェクトを作成します。Node.js 20.19+ または 22.12+ が必要です(Vite 7以降の要件)。

npm create vite@latest my-app
cd my-app
npm install
npm run dev

対話形式でフレームワークとバリアント(TypeScript / JavaScript)を選択できます。主なテンプレートは以下の通りです。

テンプレート名 フレームワーク バリアント
react-ts React TypeScript + SWC
vue-ts Vue 3 TypeScript
svelte-ts Svelte TypeScript
solid-ts Solid TypeScript
vanilla-ts なし TypeScript(フレームワークなし)

フレームワークを指定して直接作成することもできます。

# React + TypeScript を直接指定
npm create vite@latest my-react-app -- --template react-ts

vite.config.ts の設定

設定ファイルは vite.config.ts(TypeScript)または vite.config.js をプロジェクトルートに置きます。

// vite.config.ts
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import path from 'path'

export default defineConfig({
  plugins: [react()],

  // パスエイリアス(@ → src/)
  resolve: {
    alias: {
      '@': path.resolve(__dirname, './src'),
    },
  },

  // 開発サーバー設定
  server: {
    port: 3000,
    open: true,          // 起動時にブラウザを開く
    proxy: {
      '/api': {          // /api/* → バックエンドにプロキシ
        target: 'http://localhost:8080',
        changeOrigin: true,
      },
    },
  },

  // 本番ビルド設定
  build: {
    outDir: 'dist',
    sourcemap: true,     // ソースマップ生成
    minify: 'esbuild',   // minify(Vite 8: rolldownも使用可能)
  },
})

defineConfig() は TypeScript の型補完を有効にするためのラッパー関数です。値を渡すだけで機能し、実行時には何もしません。

主要機能

CSS・プリプロセッサ

Viteは追加設定なしでCSS Modules・PostCSS・CSS nesting(ブラウザネイティブ)をサポートします。SassやLessを使う場合はパッケージをインストールするだけで動きます。

# Sass を使う場合(設定不要・インストールのみ)
npm install -D sass

# Less を使う場合
npm install -D less

CSS Modulesは .module.css という拡張子のファイルを作るだけで有効になります。

/* Button.module.css */
.button {
  background: #3b82f6;
  color: white;
  padding: 0.5rem 1rem;
  border-radius: 4px;
}

/* コンポーネントからインポート */
import styles from './Button.module.css'
export const Button = ({ label }) => (
  <button className={styles.button}>{label}</button>
)

静的アセット・画像インポート

画像・フォント・SVGなどの静的ファイルはESモジュールとしてインポートできます。

// 画像を URL として取得
import logoUrl from './assets/logo.png'

// SVG を React コンポーネントとして使う(@svgr/rollup プラグイン利用)
import Logo from './assets/logo.svg?component'

// SVG を文字列として取得
import logoSvg from './assets/logo.svg?raw'

// Web Worker
import MyWorker from './worker.ts?worker'

?url・?raw・?worker などのクエリパラメータで取得方法を切り替えるのがVite独自の仕組みです。

環境変数(.env)

Viteは .env ファイルを自動で読み込みます。ただし VITE_ プレフィックスが付いた変数のみクライアントサイドに公開されます(セキュリティ上の理由)。

# .env.local
VITE_API_BASE=https://api.example.com
DATABASE_URL=postgres://...  # VITE_プレフィックスなし → ブラウザ非公開

# TypeScript でアクセス
const base = import.meta.env.VITE_API_BASE

TypeScriptで型補完を得るには vite-env.d.ts に型定義を追加します。

// src/vite-env.d.ts
/// <reference types="vite/client" />

interface ImportMetaEnv {
  readonly VITE_API_BASE: string
}

interface ImportMeta {
  readonly env: ImportMetaEnv
}

プラグインシステム

Viteのプラグインは Rollup互換プラグインAPI をベースに設計されています。Vite固有のフックを追加することで、開発サーバー向けの機能(HMRカスタマイズ、ミドルウェア追加など)も実装できます。

よく使うプラグイン

プラグイン 用途
@vitejs/plugin-react React JSX変換・Fast Refresh(Babel使用)
@vitejs/plugin-react-swc React JSX変換・Fast Refresh(SWC使用・高速)
@vitejs/plugin-vue Vue 3 SFC(.vueファイル)サポート
vite-plugin-pwa PWA(Service Worker・Web App Manifest)
vite-plugin-checker TypeScript型チェック・ESLintをワーカーで実行
@tanstack/router-vite-plugin TanStack Routerのルート自動生成
vite-plugin-svgr SVGをReactコンポーネントとして使用

カスタムプラグインの書き方

プラグインはオブジェクトを返す関数として書きます。ライブラリとして公開しない場合、vite.config.ts 内にインラインで書けます。

// vite.config.ts に直接書くシンプルなカスタムプラグイン
import type { Plugin } from 'vite'

function myHtmlInjectPlugin(): Plugin {
  return {
    name: 'my-html-inject',
    // HTML の </head> 直前にタグを注入する
    transformIndexHtml(html) {
      return html.replace(
        '</head>',
        '<meta name="app-version" content="1.0.0"></head>'
      )
    },
  }
}

export default defineConfig({
  plugins: [react(), myHtmlInjectPlugin()],
})

主なプラグインフックは以下の通りです。

フック タイミング 用途
config 設定解決前 設定オブジェクトを変更・拡張
configureServer 開発サーバー起動時 カスタムミドルウェアの追加
transform モジュール読み込み時 ファイル内容を変換(コード変換など)
transformIndexHtml HTML変換時 index.htmlへのタグ注入
handleHotUpdate ファイル変更時 HMRのカスタム制御
buildStart / buildEnd ビルド開始/終了 ファイル生成・後処理

本番ビルドの最適化

Viteの本番ビルドはVite 8からRolldownが担当し、自動的にコード分割・ツリーシェイキング・minifyを行います。

// vite.config.ts(本番最適化設定例)
export default defineConfig({
  build: {
    // ターゲットブラウザ(Vite 8デフォルト: Chrome111/Safari16.4/Firefox114)
    target: 'baseline-widely-available',

    // チャンク分割(Vite 8: codeSplitting.groups を使用)
    rolldownOptions: {
      output: {
        // 手動チャンク分割(react・react-dom を vendor チャンクに)
        manualChunks: {
          vendor: ['react', 'react-dom'],
          router: ['react-router'],
        },
      },
    },

    // 画像・静的アセットのインライン化しきい値(バイト)
    assetsInlineLimit: 4096,

    // CSS を JS から分離してファイルとして出力
    cssCodeSplit: true,

    // Rolldown の永続キャッシュを有効化(再ビルド高速化)
    cache: true,
  },
})

ビルド後の内容を確認するには npx vite-bundle-visualizer を実行するとチャンクのサイズマップが表示されます。

Vite 6 の Environment API

Environment API は Vite 6(2024年11月リリース)で導入された大きな設計変更です。これまでViteは「クライアント(ブラウザ)」と「SSR(サーバー)」の2環境を暗黙的に想定していましたが、Environment APIにより任意の環境(Cloudflare Workers・Web Workers・Node.js SSR・Edge SSRなど)を明示的に定義・管理できるようになりました。

エンドユーザーが直接使う機会は少なく、フレームワーク作者・プラグイン作者向けの機能という位置づけです。SPA開発者はVite 6への移行後も従来通りそのまま使えます。

// vite.config.ts での環境定義例(SSR + Edge の2環境)
import { defineConfig } from 'vite'

export default defineConfig({
  environments: {
    client: {
      // ブラウザ向けクライアント環境(デフォルト)
    },
    ssr: {
      // Node.js SSR 環境
      resolve: {
        conditions: ['node', 'require'],
        externalConditions: ['node'],
      },
    },
    edge: {
      // エッジランタイム向け(Cloudflare Workersなど)
      resolve: {
        conditions: ['workerd', 'browser'],
        noExternal: true,
      },
    },
  },
})

Vite 7(2025年6月リリース)ではEnvironment APIが安定化し、buildAppフックが追加されてフレームワーク側が全環境のビルドを統括できるようになりました。Cloudflare ViteプラグインがこのAPIを活用して開発時からCloudflare Workers runtimeでコードを実行できるようになっています。

Vite 8 の Rolldown 統合

Vite 8.0(2026年3月12日リリース)の最大の変更点は Rolldown の統合です。RolldownはRustで書かれた高速バンドラーで、Rollupの後継として開発され、Vite 8で本番バンドラーとして採用されました。

Vite 8 の主な変更点

  • build.rollupOptions → build.rolldownOptions:既存の rollupOptions は廃止され rolldownOptions に移行が必要
  • 新しいデフォルトブラウザターゲット:baseline-widely-available(Chrome 111 / Safari 16.4 / Firefox 114)に変更。Vite 7以前の modules より新しくなり、ビルドサイズが小さくなる
  • CommonJS互換の変化:RolldownのCJS扱いがesbuildと異なる場合があり、一部のCJS依存パッケージで動作確認が必要
  • フルバンドルモード(実験的):開発時もRolldownでバンドルするオプションが追加。大規模プロジェクトでの開発起動速度が改善
  • モジュールレベルの永続キャッシュ:ビルドキャッシュが細粒度化し、差分ビルドが大幅に速くなる
  • Module Federation サポート:複数のViteアプリ間でモジュールを共有するMicro Frontend構成が標準でサポートされる

移行: rollupOptions → rolldownOptions

移行ガイドによると、既存の rollupOptions は基本的に rolldownOptions にリネームするだけで動作しますが、一部の非対応オプションがあります。

// 【Vite 7 以前】
export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        manualChunks: { vendor: ['react', 'react-dom'] },
      },
    },
  },
})

// 【Vite 8】rolldownOptions にリネーム
export default defineConfig({
  build: {
    rolldownOptions: {
      output: {
        manualChunks: { vendor: ['react', 'react-dom'] },
      },
    },
  },
})

なお format: 'system'(SystemJS形式)はRolldownが非対応のため削除されました。使用している場合は代替フォーマット(esm や iife)への移行が必要です。

Vite バージョン変遷まとめ

バージョン リリース 主な変更 Node.js要件
Vite 5 2023年11月 Rollup 4採用・CJS非推奨 18+
Vite 6 2024年11月 Environment API(実験的) 18+
Vite 7 2025年6月 Environment API安定化・buildAppフック・baseline-widely-availableをデフォルトに・Node.js 18 EOL対応 20.19+ / 22.12+
Vite 8 2026年3月 Rolldown統合・build.rolldownOptions・Module Federation・永続キャッシュ 20.19+ / 22.12+

Vite 5/6 からの移行チェックリスト

  • build.rollupOptions を build.rolldownOptions にリネームする
  • format: 'system' を使用している場合は 'esm' または 'iife' に変更する
  • Node.jsバージョンが 20.19+ または 22.12+ であることを確認する
  • CJS依存パッケージで意図しない動作がないか確認する(npm run buildでエラーチェック)
  • ブラウザターゲットを明示している場合、baseline-widely-available への変更を検討する
  • プラグインがVite 8対応か npm で確認する(多くの主要プラグインは対応済み)

まとめ

Viteは登場以来、フロントエンドの開発体験を劇的に改善してきました。ネイティブESMによる即時起動・HMR、シンプルな設定ファイル、豊富なプラグインエコシステムがその強みです。

2026年現在のVite 8は、Rolldownの統合によってさらに高速化し、Module FederationによるMicro Frontendも標準サポートされました。Environment API(Vite 6+)の安定化でフレームワーク選択肢も広がっています。

新規プロジェクトは迷わず最新のVite 8を使いましょう。既存のVite 5/6/7プロジェクトからの移行も、主に rollupOptions → rolldownOptions のリネームが中心で、比較的スムーズに行えます。

関連記事