Skip to content

建立 2026-09-15 更新 2026-09-15

建立專案

要寫 React,本機需要 Node.js(建議 20 以上)與套件管理員。官方文件把「做產品」與「學 React」分開:產品用框架,練習用 Vite 最單純。

官方怎麼建議起步

Creating a React App 建議新應用選:

需求 常見選擇
網站、SSR、檔案路由 Next.js
以函式庫為主、自己組路由 React Router 的框架模式
手機 App Expo(React Native)

不要再用 Create React App:官方已停止維護。舊教學若出現 npx create-react-app,改成 Vite 或上方框架即可。

本站後續範例假設你用 Vite + React,這樣看到的是 React 本身,不是框架的檔案慣例。

用 Vite 建立

終端機執行:

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

瀏覽器開啟終端機印出的網址(預設 http://localhost:5173)。改 src/App.jsx 存檔後,畫面會熱更新。

--template react-ts 可改 TypeScript。觀念相同,本站範例用 JavaScript 減少語法干擾。

目錄在做什麼

my-react-app/
├── index.html          # 唯一 HTML,裡面有 <div id="root">
├── package.json
├── vite.config.js
└── src/
    ├── main.jsx        # 把 <App /> 掛到 #root
    ├── App.jsx         # 根元件,從這裡開始改
    └── index.css

main.jsx 大致是:

import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import App from "./App.jsx";

createRoot(document.getElementById("root")).render(
  <StrictMode>
    <App />
  </StrictMode>
);

createRoot 把 React 樹接上真實 DOM。StrictMode 在開發模式會多跑一次某些邏輯,用來提早抓不安全的副作用,上線建置不會這樣做。

下一步

打開 App.jsx,把內容換成自己的元件。接著讀 元件與 JSX

安裝與畫面可對照 YouTube 優質教學 裡 SuperSimpleDev、Traversy Media 的 Vite 段落。