本指南將一步步說明如何在 WSL（Windows 子系統 Linux 上）使用 Vite 前端工具建立 React 開發環境。
如果你打算部署到 Linux 伺服器、使用 Docker 容器，或使用 Bash 工具，推薦使用 WSL。 如果你是 React 新手，想快速開始，建議直接 在 Windows 上安裝 React 。
關於 React 及其不同情境的背景——網頁應用程式、行動應用程式（React Native）以及原生桌面應用程式（React Native for Desktop）——請參閱 React 概覽。
必要條件
-
WSL 2：用 Linux 發行版安裝 WSL（推薦 Ubuntu），並確認它正在以 WSL 2 模式運行：
wsl -l -v。 需使用 Windows 10 版本 2004 或更新版本，或 Windows 11。 - Node.js on WSL 2：在 WSL 發行版裡用 nvm 安裝 Node.js。 請勿在 WSL 中使用安裝的 Windows 版本 Node.js。
重要
請將專案檔案存放在 WSL 檔案系統（例如 ~/projects），而不是掛載的 Windows 磁碟機（/mnt/c/）。 跨越檔案系統邊界作業會大幅減慢安裝與建置時間。
建立你的 React 應用程式
打開你的 WSL 終端機（例如 Ubuntu）。
建立一個新的專案資料夾並輸入：
mkdir ~/ReactProjects cd ~/ReactProjects用 Vite 建立一個新的 React 應用程式：
npm create vite@latest my-react-app -- --template reactVite 會在資料夾中
my-react-app架設一個新的 React 專案。進入新的應用程式資料夾並安裝相依關係：
cd my-react-app npm install啟動本地開發伺服器：
npm run dev您的應用程式將可在
http://localhost:5173. 使用 Ctrl+C 來停止伺服器。當你準備好部署時，請建立一個生產套件：
npm run build輸出放在
dist資料夾中。 請參閱 部署靜態站點 以了解主機選項。
