Viteは、次世代のフロントエンドツールとして注目されている開発ツールで、特に開発中のビルド速度が非常に速いのが特徴です。Viteを使ってReactの環境を構築すると、軽量かつ高速な開発体験を得ることができます。この記事では、Viteを使ってReactの開発環境をセットアップする手順を解説します。
[目次を開く]
1. Viteとは?
Viteは、ビルドツールとしての機能を持ち、従来のツール(例:Webpack)と比較して非常に高速です。特に開発サーバーの起動やホットリロードが早く、ファイルサイズの大きなプロジェクトでもパフォーマンスの向上が期待できます。Viteは、モダンなブラウザのESモジュールを活用し、開発中は必要な部分のみをオンデマンドでコンパイルすることで、ビルド速度を最適化しています。
フロントエンドにおけるビルドツールについて解説をみる
ビルドツールとは、 開発用のコードを、ブラウザで動くように整えるツール のことです。
ビルドツールがやる主な仕事
処理名 | 説明 |
バンドル | 複数のJS/TSファイルを1つまたは複数のファイルにまとめる(読み込み効率UP) |
トランスパイル | TypeScriptや最新のJS(ES2023など)を古いブラウザでも動くように変換 |
CSS処理 | SassやPostCSSを使って、CSSを変換・最適化 |
画像圧縮や最適化 | PNGやSVGなどを軽くして読み込み速度を上げる |
ホットリロード | コードを保存するたびに自動でブラウザを更新(開発体験向上!) |
環境変数の注入 | .env ファイルなどから変数を注入して、環境ごとの切り替えに対応 |
代表的なビルドツール
ツール名 | 特徴 |
Webpack | 超有名。設定がやや複雑だけど柔軟性バツグン |
Vite | モダンで超高速な開発環境。VueやReactと相性よし |
Parcel | 設定不要でサクッと使える。初心者にもおすすめ |
Rollup | ライブラリ向けに最適。軽量でESモジュール対応が得意 |
なんで必要?
昔はHTML・CSS・JSをそのまま書いて終わりでしたが、現在では、「TypeScript使いたい!」「モジュール分割したい!」「SCSS使いたい!」という開発スタイルが主流なので、それらを最終的にブラウザが理解できる形にまとめるビルド処理が必要になったという背景があります。
2. ViteでReact環境をセットアップする手順
ステップ1:Viteのインストール
まず、Viteを使ったReactプロジェクトを作成します。ターミナルを開き、以下のコマンドを実行します。
npm create vite@latest
このコマンドを実行すると、Viteのプロジェクトセットアップウィザードが開始されます。プロジェクトの名前を指定したら、次に使用するフレームワークとテンプレートを選択します。
✔ Project name: … my-react-app
✔ Select a framework: › React
✔ Select a variant: › TypeScript
- Project name: プロジェクトの名前を入力します(例:
my-react-app
)。 - Select a framework: フレームワークにReactを選択します。
- Select a variant: JavaScriptを使用するか、TypeScriptを使用するか選択します。
ステップ2:依存関係のインストール
プロジェクトが作成されたら、以下のコマンドで依存関係をインストールします。
cd my-react-app
npm install
これで、必要なパッケージ(React、Viteなど)がインストールされ、React開発環境が整います。
ステップ3:開発サーバーの起動
次に、以下のコマンドで開発サーバーを起動します。
npm run dev
これで、Viteの開発サーバーが立ち上がり、http://localhost:3000
でReactアプリケーションが動作しているのを確認できます。ブラウザでこのURLを開くと、Viteでセットアップされた初期状態のReactアプリが表示されます。

この画面が表示されたら成功しています。
ステップ4:Viteのファイル構成
Viteを使用したReactプロジェクトは、次のような構成になっています。
my-react-app/
├── index.html
├── package.json
├── vite.config.js
├── public/
└── src/
├── App.jsx
├── main.jsx
└── assets/
-
index.html
: エントリーポイントとなるHTMLファイルです。Viteはここからアプリをレンダリングします。 -
vite.config.js
: Viteの設定ファイルです。必要に応じてカスタマイズできますが、デフォルトの設定でほとんどのReactプロジェクトは動作します。 -
src/
: Reactのコンポーネントやアセットが含まれているディレクトリです。App.jsx
がメインコンポーネントとして機能し、main.jsx
からApp
がレンダリングされます。
3. 基本的なReactコンポーネントの作成
Viteでセットアップされた環境が整ったら、Reactのコンポーネントを作成してみましょう。まずは、src/App.jsx
を編集して、シンプルなコンポーネントを作成します。
import { useState } from 'react';
function App() {
const [count, setCount] = useState(0);
return (
<div>
<h1>Vite + React</h1>
<p>カウント: {count}</p>
<button onClick={() => setCount(count + 1)}>
カウントアップ
</button>
</div>
);
}
export default App;
-
useState
: Reactのフックを使って状態を管理しています。 - ボタンをクリックするたびにカウントが増加するシンプルなカウントアップ機能を作成しています。
4. Viteのホットリロード機能
Viteは、コードを保存するとすぐにブラウザが更新されるホットリロード機能を備えています。これにより、開発中に手動でリロードする必要がなくなり、効率的に開発を進めることができます。
例えば、上記のApp.jsx
を編集して以下のように変更し、保存するだけでブラウザに即座に反映されます。
<h1>ViteとReactで始めるアプリ開発</h1>
5. Viteのビルドとデプロイ
開発が完了したら、Viteを使って本番環境用のビルドを作成できます。以下のコマンドでビルドを実行します。
npm run build
ビルドが成功すると、dist/
ディレクトリに本番用のファイルが生成されます。このディレクトリ内のファイルをWebサーバーにアップロードすれば、アプリケーションを公開できます。
npm run preview
また、npm run preview
を実行することで、本番環境に近い状態でアプリケーションをテストすることが可能です。
6. Viteの設定とカスタマイズ
Viteの設定は、プロジェクトのルートにあるvite.config.js
で行います。この設定ファイルでは、プラグインの導入や、ビルドの最適化、プロキシの設定など、さまざまなカスタマイズが可能です。
例:プロキシ設定
APIサーバーへのリクエストをローカルでプロキシするには、次のようにvite.config.js
に設定を追加します。
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig({
plugins: [react()],
server: {
proxy: {
'/api': 'http://localhost:5000',
},
},
});
これにより、/api
に対するリクエストはローカルのAPIサーバー(ポート5000)にプロキシされます。
まとめ
Viteを使ったReactの環境構築は非常に簡単で、セットアップから開発までのスピードが速く、効率的な開発が可能です。特に、ホットリロードや軽量なビルドシステムにより、ストレスの少ない開発体験が提供されます。Reactの学習やプロジェクトの立ち上げには、Viteを使った環境構築が非常に便利です。この記事の手順に従って、ぜひ自分のReactアプリケーションを作成してみてください。