セットアップ
Reactを動かすには、.tsx ファイルをブラウザで動くJavaScriptに変換するビルドツールが必要です。ここでは、Reactの新規プロジェクトを作るときによく使われるVite(ヴィート)を使って、最小のReactプロジェクトを準備し、開発サーバでブラウザに表示できるところまでを確認します。
1. プロジェクトの初期化
まず、Reactを扱うための空のプロジェクトを作り、Viteによる開発サーバの起動までを行います。
任意の場所に react-practice フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した react-practice フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。
react-practice ← このフォルダを作成
以下のコマンドで、npmがインストールされていることを確認します。
npm --version
以下のようにnpmのバージョンが表示されれば、インストールは確認できています。
11.x.x
バージョンが表示されない場合は、Node.jsをインストールしよう を先に実施してください。
インストールが確認できたら、以下のコマンドでVite製のReactプロジェクトを、いま開いているカレントフォルダに生成します。
npm create vite@latest . -- --template react-ts
npm create vite@latest はViteの公式スキャフォールディングコマンドで、直後の . は「カレントフォルダ(いま開いている react-practice)に生成する」ことを指定し、-- --template react-ts の部分で「React + TypeScript のテンプレート」を指定しています。
実行中に対話プロンプトが順に出るので、以下のように答えます。
Package name:→ そのまま Enter(フォルダ名のreact-practiceが使われます)Ok to proceed? (y)→yを入力して EnterWhich linter to use?→Oxlintを選択して EnterInstall with npm and start now?→Yesを選択して Enter
最後の Install with npm and start now? に Yes と答えると、Viteがスキャフォールディング・依存パッケージのインストール・開発サーバの起動までまとめて実施します。以下のような実行結果が表示されれば、開発サーバの起動まで完了しています。
◇ Scaffolding project in /path/to/react-practice...
◇ Installing dependencies with npm...
added 27 packages, and audited 28 packages in 2s
found 0 vulnerabilities
◇ Starting dev server...
> react-practice@0.0.0 dev
> vite
VITE v8.x.x ready in 500 ms
➜ Local: http://localhost:5173/
➜ Network: use --host to expose
➜ press h + enter to show help
Visual Studio Codeのサイドバーには、以下のような構成が表示されます。
react-practice/
├── node_modules/
├── public/
├── src/
│ ├── App.css
│ ├── App.tsx
│ ├── assets/
│ ├── index.css
│ ├── main.tsx
│ └── vite-env.d.ts
├── .gitignore
├── index.html
├── package.json
├── tsconfig.json
├── tsconfig.node.json
└── vite.config.ts
以降の節で編集するファイルは、主に src/App.tsx の1つだけです。他のファイルはViteの設定や雛形として初期状態のまま使います。
| 💡 ポイント |
|---|
このコマンドを実行したターミナルは開発サーバに占有されたままになります。以降のコマンドを実行するときは、Visual Studio Codeで「ターミナル」→「新しいターミナル」から別のターミナルを開いてください。開発サーバを止めたい場合は、動いているターミナルで Ctrl + C を押します。 |
2. 動作確認
セットアップの最後で開発サーバが起動しているので、ブラウザから表示できるかを確認します。
ブラウザで http://localhost:5173 を開くと、React と Vite のロゴを重ねたイラスト、Get started の大きな見出し、Edit src/App.tsx and save to test HMR の案内、Count is 0 の薄紫色のボタン、下部に Documentation と Connect with us のカードが並んだ、Viteのウェルカム画面が表示されます。

Count is 0 のボタンをクリックすると、Count is 1・Count is 2 と数字が1ずつ増えていきます。以下は4回クリックしたあとの状態です。

クリックのたびにボタン内の数字が追随して変われば、Reactの開発サーバが正しく動作していることが動作確認できます。
| ⚠️ ポートが 5173 以外に切り替わる場合 |
|---|
別のプロセスがすでに 5173 番ポートを使っている場合、Viteは自動的に 5174・5175 など次に空いているポートを使います。ブラウザで開くURLは、ターミナルに表示されている Local: http://localhost:XXXX/ のポート番号に合わせてください。 |