前端基礎結構審核 是做什麼的?
「一個元件應該只做好一件事。如果你需要用『而且』來描述它,那就拆開它。」
何時啟用
在審查以下內容時啟用此技能:
- React/Vue/Svelte 元件
- UI 渲染邏輯
- 狀態管理程式碼
- CSS/樣式決策
- 客戶端路由
審查清單
元件架構
- 單一職責:每個元件是否只做一件事?
- 大小檢查:元件是否少於 200 行?
- Props 數量:是否少於 7 個 props?
- 命名:能否不用「而且」來描述這個元件?
狀態管理
- 共置:狀態是否盡可能靠近使用它的地方?
- 提升:兄弟元件之間是否透過父元件正確共享狀態?
- Context vs Props:是否避免了 prop drilling(最多 3 層)?
- 伺服器狀態:伺服器資料是否獨立管理(React Query/SWR)?
效能
- 記憶化:昂貴的計算是否包在 useMemo 中?
- 回呼:事件處理函式是否在必要時用 useCallback 包裹?
- 重新渲染:是否會導致不必要的重新渲染?
- 延遲載入:重量級元件是否通過程式碼分割載入?
無障礙
- 語義化 HTML:是否使用了正確的元素(button vs div)?
- ARIA:互動元素是否可存取?
- 鍵盤:使用者能否不使用滑鼠就能導航?
常見錯誤(反模式)
1. God 元件
❌ UserDashboard.tsx (1000 行)
- 取得資料、管理狀態、渲染 UI、處理路由
✅ 拆分為:
- UserDashboardPage.tsx (容器)
- UserStats.tsx (展示)
- UserActivity.tsx (展示)
- useUserData.ts (hook)
2. 渲染邏輯內嵌
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. Prop Drilling
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // 在 Widget.tsx 中
4. 布林值 Props 爆炸
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
蘇格拉底式提問
用這些問題引導新手,而不是直接給答案:
- 架構:「這個元件的『一個職責』是什麼?」
- 拆分:「如果我要你把 header 部分單獨用在其他地方,你做得到嗎?」
- 狀態:「誰需要這份資料?它應該放在這裡還是更高層?」
- 效能:「當父元件重新渲染時會發生什麼事?」
- 複雜度:「一個新開發者能在 5 分鐘內看懂這個嗎?」
標準文件參考
詳細的模式請參閱:
/standards/frontend/component-architecture.md
需標記的紅旗
| 紅旗標記 | 應提問 |
|---|---|
| 檔案 > 200 行 | 「我們可以把它拆成更小的部分嗎?」 |
| > 5 個 useState 呼叫 | 「部分狀態是否需要提升或合併?」 |
| useEffect 的 [] 依賴但使用外部值 | 「我們是否遺漏了依賴?」 |
| 直接 DOM 操作 | 「有沒有 React 的方式可以做到?」 |
| 到處都是內聯樣式 | 「我們應該使用一致的樣式方法嗎?」 |