狀態管理
優先級:P2(中)
實作指南
- URL 狀態:將 URL 作為可分享/持久化狀態的單一事實來源。URL 參數:可在重新載入及連結間共享。透過
useSearchParams()存取,並以useRouter()更新。模式:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...)。 - 伺服器狀態:使用 SWR 或 TanStack Query (React Query) 來快取及擷取伺服器資料。避免手動將伺服器資料同步至
useState。 - 客戶端狀態:使用 Zustand(
create<CartState>()((set) => ({ ... })))——僅在 'use client' 元件中使用——或 Jotai 處理複雜、高頻率的 UI 狀態。僅對低頻率資料使用 Context API 來避免 Props Drilling。 - 狀態提升:盡可能將狀態與其使用的元件就近放置。僅當狀態需在兄弟元件間共享時,才將其提升至父層。
- Next.js 15+ 整合:確保客戶端元件中的狀態更新不與伺服器端渲染邏輯衝突。使用
useOptimisticHook 管理樂觀更新。 - 狀態水合:在客戶端元件中從
localStorage初始化狀態時需小心,以避免水合錯誤。請包裝在useEffect中或使用mounted標記。
2. URL 驅動狀態(搜尋/篩選)
使用 useSearchParams + useRouter 來更新 URL 參數。請參閱 URL 狀態模式。
3. 伺服器狀態(TanStack Query / SWR)
若需在客戶端取得「即時」資料(例如輪詢股票價格、聊天功能),請勿手動使用 useEffect 以 fetch 處理。請使用程式庫。
// 自動快取、去重及重新驗證,並搭配 refreshInterval
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
程式庫模式
針對特定狀態管理模式,請參閱:
反模式
- 不要為簡單狀態使用全域儲存:使用
useState或 URL 參數;避免為基本的 UI 使用 Zustand。 - 不要在狀態中存放大型物件:將其分解為細粒度的原始類型,以防止額外重新渲染。
- 不要使用
useEffect進行資料擷取:使用 SWR 或 TanStack Query 處理伺服器狀態。 - 不要在客戶端儲存中存放伺服器狀態:在 RSC 中擷取;客戶端儲存僅用於 UI 狀態。