状態管理ライブラリは、入れる前に大半が要りません。何に困ったら入れるのかを、条件で決められるようにします。
これは深掘りです。本線の順路ではありません。 本線の状態管理はライブラリの話ではない — Contextまでを読み終えて、「で、結局ライブラリは入れるのか入れないのか」が宙に浮いたままの人が読む記事です。飛ばしても本線は進みます。
この記事のコマンドは、すべて VM の中(Ubuntu Server)で打ちます。 Windows の PowerShell ではありません。 画面の確認は、ホストの Windows のブラウザで行います。 本線で作った
~/react-demo/には触りません。 この記事では、まっさらな~/reactlab/を新しく作ります。ポートは 5186 を使います。
React を始めて2週間目に、こう書いてある記事を読みました。
Reactには状態管理ライブラリが必須です。
素直に信じました。名前が並んでいたので、一番よく見かけたものを npm install しました。そして、作りかけの ToDo アプリの状態を、全部そこに移しました。
- 入力途中の文字を、ストアに入れました
- APIから取ってきた一覧を、ストアに入れました
- 開いているタブの名前を、ストアに入れました
- ダークモードかどうかを、ストアに入れました
動きました。 動いたのですが、3日後に自分の書いたコードが読めなくなりました。
「この一覧、いつ取り直されるんだっけ」「このタブの状態、リロードしたら消えるのはなぜ」「入力欄が1文字ごとに全部再描画されているのは、ライブラリのせい?」
そして、あとから全部を素の React に戻したら、コードが短くなりました。
戻した結果、ストアに残ったのは4つだけでした。テーマ、サイドバーの開閉、通知、ログイン情報。 それ以外は、そもそもストアに置くべきものではありませんでした。
「状態管理ライブラリが要る」と思っている状態の大半は、状態管理ライブラリの担当ではありません。
この記事は、その仕分けの記事です。先に4種類に分けます。 そのうえで、本当に残ったぶんだけを Zustand に置き換えて、何が良くなるかを再描画の回数で数えます。
対象レベル: 中級〜上級 / 区分: 発展
この記事でわかること
- 「状態」はひとかたまりではなく、少なくとも4種類あること。サーバーのデータ / URLの状態 / フォームの入力 / 本当のクライアント状態で、担当する道具が全部違う
- ライブラリが欲しくなる場面の大半は、サーバーのデータであること。そこはキャッシュの問題で、状態管理の問題ではない
- URLの状態は、URLに置くこと。ストアに置くと、リロードで消え、共有したリンクが別の画面を開く
- 仕分けたあとに残るクライアント状態は、驚くほど少ないこと。テーマ・サイドバーの開閉・通知・認証情報くらい
- Context と状態管理ライブラリの決定的な差は「セレクタ」1点であること。Context は「この人には要らない」を判断できない
- Zustand は Provider を要求しないこと。ストアは React の外にあり、フックは購読しているだけ
- セレクタを付けないと、Zustand でも全部再描画されること。入れただけでは速くならない
- Redux Toolkit / Jotai / MobX は「同じものの別実装」ではないこと。中央集権 / 原子 / 監視という、考え方そのものが違う
- 入れると、増える仕事があること。「どこで何が変わったか」が追いにくくなり、DevTools とテストの手当てが要る
この記事でやること
~/reactlab/を新しく作り、ポート 5186番で起動する- 手元の状態を4種類に仕分ける表を作り、ストアに残るものが何本あるかを数える
- 残ったぶんを Context で作り、Contextの回の結論(分割してもセレクタが無い)を、もう一度目で見る
- Zustand を入れて、同じものを
createとセレクタで書き直す - 再描画の回数を数えて、「使っている値だけで再描画される」ことを確かめる
- 入れる前のチェック3項目に自分のプロジェクトを通す
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 状態管理ライブラリ | 複数の画面から読み書きする値を、1箇所にまとめて置くための外部ライブラリ。React 本体の機能ではない |
| ストア(store) | その「1箇所」の置き場所そのもの。 値と、値を変える関数が入っている |
| セレクタ(selector) | ストアから「自分が使う部分だけ」を取り出す関数。 (s) => s.theme のような形。この記事の主役 |
| 購読(subscribe) | 値が変わったら教えてもらう約束。セレクタがあると「この部分が変わったときだけ」に絞れる |
| サーバー状態(server state) | 本当の持ち主がサーバーにあるデータ。手元にあるのは写しなので、古くなる |
| クライアント状態(client state) | 持ち主が自分(ブラウザ)のデータ。誰にも聞かずに決められる値 |
| 中央集権型 | 状態を1つの大きな箱にまとめる考え方(Redux / Zustand) |
| 原子(atom)型 | 状態を小さな粒に分けて撒き、必要な粒だけを読む考え方(Jotai / Recoil) |
| 監視(observable)型 | オブジェクトを普通に書き換えると、見ている画面が勝手に更新される考え方(MobX) |
| ボイラープレート | 中身は違うのに、毎回ほぼ同じ形で書かされる決まり文句のコード |
① 練習場を作る
本線で作った ~/react-demo/ は触りません。 壊しながら試すので、別のプロジェクトを1つ作ります。
VMの中で実行します。
確認: ls src で App.jsx と main.jsx が出れば成功です。
App.css App.jsx assets index.css main.jsx
ポートを開けます。この記事では 5186 を使います。(他の深掘り記事の練習場と同時に動かしても、ぶつからないようにするためです)
確認: 一覧に 5186/tcp ALLOW が出ていれば成功です。
起動します。
--host 0.0.0.0 が要る理由は、これが無いと VM の中からしか繋がらないからです(ネットワークの回)。VM の IP は ip a で調べます。
ホストの Windows のブラウザで http://<VMのIP>:5186/ を開いて、Vite のロゴが出れば準備完了です。
数えるために、StrictMode を外す
この記事も「何回再描画されたか」を数えます。 StrictMode が付いていると、開発中は関数がわざと2回呼ばれるので(再描画の回で扱いました)、数字が全部2倍になって読みにくくなります。
この記事の間だけ外します。src/main.jsx を、こう書き換えます。
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'
createRoot(document.getElementById('root')).render(<App />)
本番のコードで外してはいけません。 外すのは「数を数える実験のときだけ」で、この記事の最後(後片づけ)で戻します。
② 先に、状態を4種類に分ける
ライブラリの話をする前に、これをやります。 ここを飛ばすと、入れても片づきません。
手元のアプリで「状態」と呼んでいるものを、全部紙に書き出して、この4つのどれかに振り分けます。
| 種類 | 具体例 | 本当の持ち主 | 担当する道具 |
|---|---|---|---|
| ① サーバーのデータ | 記事一覧、ユーザー情報、在庫数、検索結果 | サーバー(手元にあるのは写し) | TanStack Query / SWR |
| ② URLの状態 | 開いているタブ、検索語、ページ番号、絞り込み条件 | URL(アドレスバー) | ルーター / URLSearchParams |
| ③ フォームの入力 | 入力途中の文字、検証エラー、送信中かどうか | その画面のフォーム | useState(多ければフォーム用ライブラリ) |
| ④ 本当のクライアント状態 | テーマ、サイドバーの開閉、通知、認証情報 | アプリ全体 | useState + Context →(足りなければ)状態管理ライブラリ |
状態管理ライブラリの担当は、④だけです。 ①②③は、担当が別にいます。
①「状態管理ライブラリが要る」の大半は、これ
「一覧をどこからでも読みたい」「登録したら一覧を更新したい」「同じデータを2画面で使いたい」。
この3つは、全部サーバーのデータの話です。 そして、サーバーのデータは状態ではありません。キャッシュです。
- 状態は、自分が決めた値です。誰にも聞かずに変えられます
- サーバーのデータは、本体がよそにあります。 自分の手元の値は、放っておくと勝手に古くなります
古くなる値をストアに入れると、「いつ取り直すか」を自分で書くことになります。 それが前回の記事で数えた 203行でした。
一覧データをストアに入れているなら、それはライブラリの選択を間違えているのではなく、種類の判定を間違えています。 そこは TanStack Query の回でやったとおり、キャッシュの道具の担当です。
この判定を1回やるだけで、ストアに入れるつもりだったものの大半が消えます。 私の場合、書き出した11本のうち6本が①でした。
② URLの状態は、URLに置く
「いま開いているタブ」「検索欄に入れた文字」「一覧の2ページ目」。
これを useState やストアに置くと、次の3つが黙って壊れます。
- リロードすると、1ページ目に戻る
- ブラウザの戻るボタンが効かない(またはアプリ全体から出てしまう)
- 画面のリンクを人に送っても、相手には別の画面が開く
3番目が一番痛いです。「この検索結果を見て」と URL を送って、相手が空の画面を見るという事故になります。
置き場所を URL にすると、この3つが同時に直ります。 ブラウザが履歴を持っていて、リロードでも消えず、コピーすれば他人にも同じ画面が出ます。
// 現在のURLが http://example.com/books?q=react&page=2 のとき
const params = new URLSearchParams(location.search)
params.get('q') // 'react'
params.get('page') // '2'
実際のアプリでは、これを直接触るのではなく、ルーターに任せます(ルーティングの回)。
「URLに出したくない」という理由でストアに置くのは、たいてい間違いです。 URLに出したくないのは、ふつう③のフォーム入力のほうです。画面の位置を表す値は、URLに出ているのが正しい状態です。
③ フォームの入力は、その画面から出さない
入力途中の文字は、1文字打つたびに変わります。
これを全体のストアに置くと、1文字ごとに、そのストアを読んでいる全員が再描画されます。 これはフォームの回で実測しました。画面全体が、キーを打つたびに描き直されます。
入力値は、その画面(できればそのフォーム)の中に閉じ込めます。 外に出るのは、送信ボタンを押したあとの結果だけです。
④ ここだけが、状態管理ライブラリの担当
残ったものを見ます。次の章です。
③ 残るものを、実際に数える
私が書き出した11本を、②の表で振り分けた結果です。
| 書き出した状態 | 判定 | 置き場所 |
|---|---|---|
| 記事一覧 | ① サーバー | Query |
| 記事の詳細 | ① サーバー | Query |
| 検索結果 | ① サーバー | Query |
| ログインユーザーのプロフィール | ① サーバー | Query |
| 通知の未読件数(サーバー由来) | ① サーバー | Query |
| お気に入り一覧 | ① サーバー | Query |
| 検索語 | ② URL | ルーター |
| 開いているタブ | ② URL | ルーター |
| 投稿フォームの入力値 | ③ フォーム | その画面の useState |
| ダークモードかどうか | ④ クライアント | ストア |
| サイドバーが開いているか | ④ クライアント | ストア |
11本のうち、残ったのは2本でした。
実際のアプリでは、もう少しだけ増えます。④として残りやすいのは、次の4つくらいです。
| 残るもの | なぜ④なのか |
|---|---|
| テーマ(ダーク / ライト) | サーバーに聞かなくても決まる。読む場所がとても多い |
| サイドバー・モーダルの開閉 | 画面の見た目の状態。URLに出す場合もある(モーダルは出したほうがいいことも多い) |
| 通知(トースト)の一覧 | どこからでも追加され、どこか1箇所で表示される。 追加する側と表示する側が遠い |
| 認証情報(ログイン中かどうか、トークン) | アプリ全体の分岐に使う。トークン本体の扱いは認証の回の話で、置き場所とは別問題 |
多くて4〜6本です。 数十本にはなりません。
ここまで来て、はじめて「Context で足りるか」を考えます。 4〜6本しかないなら、まず Context です。 本当に足りないと分かってから、ライブラリを入れます。
④ まず Context で作る(そして限界を思い出す)
残った ④ を、Context で作ります。 これが比較の土台になります。
src/UiContext.jsx を作ります。
import { createContext, useContext, useMemo, useState } from 'react'
const UiContext = createContext(null)
export function UiProvider({ children }) {
const [theme, setTheme] = useState('light')
const [sidebarOpen, setSidebarOpen] = useState(false)
const [notices, setNotices] = useState([])
const value = useMemo(() => ({
theme,
sidebarOpen,
notices,
toggleTheme: () => setTheme((t) => (t === 'light' ? 'dark' : 'light')),
toggleSidebar: () => setSidebarOpen((v) => !v),
pushNotice: (text) => setNotices((list) => [...list, text]),
}), [theme, sidebarOpen, notices])
return <UiContext.Provider value={value}>{children}</UiContext.Provider>
}
export function useUi() {
const ctx = useContext(UiContext)
if (ctx === null) throw new Error('useUi は UiProvider の中で使ってください')
return ctx
}
createContext(null)とthrowの組み合わせは、Contextの回でやった定型です。Provider の囲み忘れが、既定値で静かに通ってしまう事故を防ぎます。
再描画を数える小さなフックを src/useRenderCount.js に置きます。
import { useRef } from 'react'
export function useRenderCount(name) {
const n = useRef(0)
n.current += 1
console.log(`${name}: ${n.current}回目`)
return n.current
}
読む側を3つ作ります。src/Parts.jsx です。
import { useUi } from './UiContext.jsx'
import { useRenderCount } from './useRenderCount.js'
export function ThemeLabel() {
const { theme } = useUi()
const n = useRenderCount('ThemeLabel')
return <p>テーマ: {theme} <small>(描画 {n} 回)</small></p>
}
export function SidebarLabel() {
const { sidebarOpen } = useUi()
const n = useRenderCount('SidebarLabel')
return <p>サイドバー: {sidebarOpen ? '開' : '閉'} <small>(描画 {n} 回)</small></p>
}
export function NoticeButton() {
const { pushNotice } = useUi()
const n = useRenderCount('NoticeButton')
return (
<button onClick={() => pushNotice('こんにちは')}>
通知を1件足す(描画 {n} 回)
</button>
)
}
src/App.jsx を書き換えます。
import { UiProvider, useUi } from './UiContext.jsx'
import { ThemeLabel, SidebarLabel, NoticeButton } from './Parts.jsx'
function Controls() {
const { toggleTheme, toggleSidebar } = useUi()
return (
<div>
<button onClick={toggleTheme}>テーマ切替</button>
<button onClick={toggleSidebar}>サイドバー切替</button>
</div>
)
}
export default function App() {
return (
<UiProvider>
<h1>Context 版</h1>
<Controls />
<NoticeButton />
<ThemeLabel />
<SidebarLabel />
</UiProvider>
)
}
数える
ブラウザで http://<VMのIP>:5186/ を開き、F12 で Console を出します(開発者ツールの回)。
「通知を1件足す」を3回押してください。 テーマもサイドバーも、1ミリも変えていません。
ThemeLabel: 2回目
SidebarLabel: 2回目
NoticeButton: 2回目
ThemeLabel: 3回目
SidebarLabel: 3回目
NoticeButton: 3回目
ThemeLabel: 4回目
SidebarLabel: 4回目
NoticeButton: 4回目
押した回数だけ、全員が再描画されています。
[スクリーンショット: 01_context_全部再描画.png] 「通知を1件足す」を3回押したあとの Console を撮ってください。ThemeLabel と SidebarLabel が、押した回数ぶん増えているところが写るようにしてください。
理由は簡単です。 notices が変わる → useMemo の依存に notices が入っている → value が新しくなる → useContext している全員に通知が行く。
分けても、消えない
Contextの回では、これをContext の分割で減らしました。テーマ用、サイドバー用、通知用に3つに割れば、通知を足しても ThemeLabel は再描画されません。
そこまでは直ります。 ですが、次が直りません。
1つの Context の中に値が2つ以上あると、そのどちらが変わっても、両方の読者が再描画される。
たとえば通知の Context に notices(一覧)と unreadCount(未読数)を入れると、一覧しか使っていない部品も、未読数が変わるたびに再描画されます。
これを消すには「この人は notices しか使っていないので、unreadCount の変更では起こさない」という判断が要ります。 その判断をする関数がセレクタです。
Context にはセレクタがありません。
useContextは「その Context の値」を丸ごと受け取る API で、「一部だけ」を指定する口が無いからです。 だから Context を分ける = 手でセレクタの代わりをしていることになります。値の数だけ Context とファイルが増えます。
ここが、ライブラリの出番です。 ここまで来ていないのに入れるのは、早すぎます。
⑤ Zustand に置き換える
同じものを、Zustand で作ります。 まず入れます。
確認: package.json の dependencies に zustand が入っていれば成功です。
ストアを1つ作る
src/uiStore.js を作ります。これで全部です。
import { create } from 'zustand'
export const useUiStore = create((set) => ({
theme: 'light',
sidebarOpen: false,
notices: [],
toggleTheme: () => set((s) => ({ theme: s.theme === 'light' ? 'dark' : 'light' })),
toggleSidebar: () => set((s) => ({ sidebarOpen: !s.sidebarOpen })),
pushNotice: (text) => set((s) => ({ notices: [...s.notices, text] })),
}))
読み方を分解します。
| 書いたもの | 意味 |
|---|---|
create(...) | ストアを1つ作る。 返ってくるのはフック(useUiStore)。だから名前が use で始まる |
(set) => ({ ... }) | ストアの中身を返す関数。 set は「更新する係」 |
theme: 'light' | 値。 useState の初期値にあたる |
toggleTheme: () => ... | 更新関数も、値と同じ場所に置く。 Context 版と違って、外に切り出さなくていい |
set((s) => ({ theme: ... })) | 返したキーだけが差し替わる。 書かなかった notices はそのまま残る(部分更新) |
setは「上書き」ではなく「マージ」です。set({ theme: 'dark' })と書いてもsidebarOpenは消えません。 ここは Redux の reducer(毎回、状態の全体を返す)と違うところで、最初に戸惑いました。
読む側を、セレクタで書く
src/PartsZ.jsx を作ります。Context 版との違いは、たった1行です。
import { useUiStore } from './uiStore.js'
import { useRenderCount } from './useRenderCount.js'
export function ThemeLabelZ() {
const theme = useUiStore((s) => s.theme) // ← セレクタ
const n = useRenderCount('ThemeLabelZ')
return <p>テーマ: {theme} <small>(描画 {n} 回)</small></p>
}
export function SidebarLabelZ() {
const sidebarOpen = useUiStore((s) => s.sidebarOpen)
const n = useRenderCount('SidebarLabelZ')
return <p>サイドバー: {sidebarOpen ? '開' : '閉'} <small>(描画 {n} 回)</small></p>
}
export function NoticeButtonZ() {
const pushNotice = useUiStore((s) => s.pushNotice)
const n = useRenderCount('NoticeButtonZ')
return (
<button onClick={() => pushNotice('こんにちは')}>
通知を1件足す(描画 {n} 回)
</button>
)
}
(s) => s.theme の部分がセレクタです。 これが、「私は theme しか使っていません」という申告になります。
src/App.jsx を書き換えます。注目してほしいのは、<UiProvider> が無いことです。
import { useUiStore } from './uiStore.js'
import { ThemeLabelZ, SidebarLabelZ, NoticeButtonZ } from './PartsZ.jsx'
function ControlsZ() {
const toggleTheme = useUiStore((s) => s.toggleTheme)
const toggleSidebar = useUiStore((s) => s.toggleSidebar)
return (
<div>
<button onClick={toggleTheme}>テーマ切替</button>
<button onClick={toggleSidebar}>サイドバー切替</button>
</div>
)
}
export default function App() {
return (
<>
<h1>Zustand 版</h1>
<ControlsZ />
<NoticeButtonZ />
<ThemeLabelZ />
<SidebarLabelZ />
</>
)
}
⑥ 再描画の回数を数える
Console を一度クリアしてから、また 「通知を1件足す」を3回押してください。
NoticeButtonZ: 1回目
ThemeLabelZ: 1回目
SidebarLabelZ: 1回目
最初の1回だけです。 3回押しても、何も増えません。
[スクリーンショット: 02_zustand_再描画されない.png] Zustand 版で「通知を1件足す」を3回押したあとの Console を撮ってください。ThemeLabelZ と SidebarLabelZ が 1回目 のままであることが分かるようにしてください。
次に「テーマ切替」を押します。
ThemeLabelZ: 2回目
ThemeLabelZ だけです。 SidebarLabelZ も NoticeButtonZ も動きません。
Context 版と並べます。
| 操作 | Context 版(1つにまとめた場合) | Zustand 版(セレクタあり) |
|---|---|---|
| 通知を1件足す | 3つ全部が再描画 | 0(誰も再描画されない) |
| テーマ切替 | 3つ全部が再描画 | ThemeLabelZ だけ |
| サイドバー切替 | 3つ全部が再描画 | SidebarLabelZ だけ |
これが、セレクタの正体です。 「使っている値だけ」で起きる、という一点だけのために入れています。
なぜこれができるのか
ストアが React の外にあるからです。
- Context: 値は React のツリーの中にあり、Provider の再描画に相乗りして流れます。 だから「途中で誰かを止める」ことができません
- Zustand: 値はただの JavaScript のオブジェクトとして React の外にあります。フックはそこを見張っているだけです。値が変わると、購読者ごとに「セレクタの結果が変わったか」を比べ、変わった人だけ再描画します
セレクタを書かないと、この効果は出ません。
const s = useUiStore()と書くと、ストア全体を購読することになり、Context 版と同じ「全部再描画」に戻ります。 これが Zustand で一番多い事故です。入れただけでは速くなりません。
セレクタで、もう1つの事故
// v5 では無限ループで落ちることがある(v4 までは毎回再描画)
const { theme, sidebarOpen } = useUiStore((s) => ({ theme: s.theme, sidebarOpen: s.sidebarOpen }))
セレクタが毎回「新しいオブジェクト」を返しているので、中身が同じでも別物と判定されます。 Context の value={{ a, b }} と同じ問題です。いま npm install zustand で入る v5 では、再描画が増えるだけでは済まず、Maximum update depth exceeded のエラーで画面が落ちることがあります。
素直な直し方は、行を分けることです。
const theme = useUiStore((s) => s.theme)
const sidebarOpen = useUiStore((s) => s.sidebarOpen)
2行になっても、こちらのほうが安全です。 どうしてもまとめたいときだけ、import { useShallow } from 'zustand/shallow' で読み込んだ useShallow でセレクタを包みます(useUiStore(useShallow((s) => ({ theme: s.theme, sidebarOpen: s.sidebarOpen }))))。
⑦ Provider が要らない、という違い
Zustand 版の App.jsx には、囲みのタグがありません。
| Context | Zustand | |
|---|---|---|
| 囲むタグ | 必要(<UiProvider>) | 不要 |
| 囲み忘れ | 既定値が静かに使われる or throw | 起きない(囲むものが無い) |
| React の外から読む | できない | できる(useUiStore.getState()) |
| テストのとき | 毎回 Provider で包む必要がある | 包まなくていい。代わりに状態のリセットが必要 |
3行目が地味に効きます。React のコンポーネントではない場所、たとえば通信のエラー処理の中から、こう書けます。
import { useUiStore } from './uiStore.js'
export function apiErrorHandler(err) {
useUiStore.getState().pushNotice(`通信に失敗しました: ${err.message}`)
}
Context だとこれができません。 useContext はコンポーネントの中でしか呼べないからです。
ただし、これは「便利」であると同時に「危ない」ことでもあります。 どこからでも状態を書き換えられるということは、「誰がこれを変えたのか」を探すのが難しくなるということです。⑩で扱います。
⑧ 他の選択肢を、性格の違いで見る
Zustand が唯一の答えではありません。 ただし、「どれも同じことをする別の書き方」でもありません。 考え方が違います。
| ライブラリ | 性格 | 状態の置き方 | 変え方 | 向くとき |
|---|---|---|---|---|
| Zustand | 中央集権(小さい) | 1つのストアに値と関数をまとめる | 関数の中で set を呼ぶ | ④が数本〜十数本。まず試すもの |
| Redux Toolkit | 中央集権(厳格) | slice に分けて1つの store に束ねる | action を dispatch し、reducer が返す | 人数が多い / 変更の履歴を追う必要がある |
| Jotai | 原子 | atom を小さく撒く。中央の箱が無い | atom ごとに更新する | 状態が細かく分岐し、組み合わせが多い |
| MobX | 監視 | 普通のオブジェクトを書き換えるだけ | obj.count++ のように書く | オブジェクト指向で設計したい |
Redux Toolkit
Redux は「状態管理ライブラリ」の代名詞ですが、いま名前だけで避けられがちです。 避けられている理由は、素の Redux のボイラープレートが多かったことでした。Redux Toolkit は、そこを畳んだ公式の道具です。
それでも Zustand より書く量は多くなります。その代わりに手に入るのが、「変更が必ず action を通る」という制約です。
- すべての変更に名前が付きます(
cart/itemAddedのような) - DevTools で、変更の一覧を時系列で見られます。 巻き戻しもできます
- 「誰がこれを変えたのか」を探す作業が、ほぼ消えます
5人で1つの画面を触っているなら、この制約は窮屈さより価値のほうが大きいことがあります。一人で作っているうちは、たいてい重いだけです。
Jotai
中央の箱を作りません。 atom という小さな粒を作って、必要なところで読みます。
「セレクタを書く」のではなく、「最初から小さく分かれている」という発想です。粒どうしを組み合わせて、「Aが変わったら自動で計算し直す粒」を作れます。
状態が細かく、しかも依存し合っているときに向きます。逆に、④が4本しかないなら、粒に分ける旨みがありません。
MobX
obj.count++ と書くと、それを見ている画面が勝手に更新されます。
書き味は一番短いです。 代わりに、「どこで変わったか」が一番見えにくくなります。 React の「状態は上から下へ流れる」という前提とも、考え方がずれます。
すでに MobX を使っているチームに入るなら覚える価値がありますが、いまから一人で始める理由は薄いというのが、私の結論です。
⑨ 入れる前のチェック
入れる前に、この3つを自分に聞きます。 1つでも「いいえ」なら、入れません。
1. Context で足りないと、測って分かったか
「なんとなく重そう」で入れないでください。
- ④に振り分けた状態は、何本ありますか(数えましたか)
- Context を分けても直らない再描画が、実際に起きていますか
- その再描画は、Console の数字か Profiler で確認しましたか
この記事で数えたように、まず数えます。 ④が4本で、Context を3つに分けて足りているなら、入れる理由がありません。
2. サーバーのデータを入れようとしていないか
②の表に戻ってください。
- 入れようとしている値の本当の持ち主は、サーバーですか
- 「いつ取り直すか」を自分で書こうとしていませんか
「はい」なら、それはキャッシュの道具の担当です。 状態管理ライブラリを入れても、203行はそのまま残ります。
3. チームで合意があるか
一人でも、これは効きます。 半年後の自分は他人です。
- 「④だけを入れる」というルールを、書き留めましたか
- 入れたあと、「便利だから」とサーバーのデータやフォーム入力が流れ込むのを、誰が止めますか
状態管理ライブラリが破綻するのは、性能ではなく、この規律が崩れたときです。 私が最初に失敗したのも、ライブラリのせいではなく、全部そこに入れたからでした。
ストアは、置ける場所であって、置くべき場所ではありません。
⑩ 入れたあとに増える仕事
入れると減る仕事ばかり書かれますが、増える仕事もあります。 先に知っておきます。
1. 「どこで何が変わったか」が追いにくくなる
useState なら、その値を変えられるのは、その関数の中だけです。読めば分かります。
ストアは、アプリのどこからでも書き換えられます。 useUiStore.getState().pushNotice(...) は、React の外からでも呼べます。
「テーマが勝手に戻る」というバグを追うときに、探す範囲がアプリ全体になります。
対策は、書き換える口を絞ることです。
setを、コンポーネントから直接呼ばない。 ストアの中に定義した関数(toggleThemeなど)だけを外に出す- 関数名を、起きたことの名前にする。
setThemeよりtoggleTheme、setNoticesよりpushNotice getState()での書き換えは、React の外(通信のエラー処理など)だけに限る
2. DevTools の手当てが要る
Redux Toolkit には、最初から強い DevTools が付いています。 変更の一覧と巻き戻しが、入れた瞬間から使えます。
Zustand は、自分で繋ぎます。 devtools というミドルウェアを挟むと、Redux DevTools 拡張で見られるようになります。
import { create } from 'zustand'
import { devtools } from 'zustand/middleware'
export const useUiStore = create(devtools((set) => ({
theme: 'light',
toggleTheme: () => set((s) => ({ theme: s.theme === 'light' ? 'dark' : 'light' }), false, 'toggleTheme'),
})))
3つ目の引数 'toggleTheme' が、変更に付ける名前です。 これを書かないと、DevTools の履歴が全部「匿名の更新」になり、意味がなくなります。
この記事の練習では入れていません。 実際に使うときは、最初から入れておいたほうがいいです。あとから全部の
setに名前を付けて回るのは、つらい作業です。
3. テストで、状態のリセットが要る
Context には、この問題がありません。 テストのたびに Provider で包み直すので、毎回まっさらから始まります。
ストアは、モジュールとして1つしかありません。 テストを2本続けて実行すると、1本目で変えた状態が、2本目に残ります。
「単体では通るのに、まとめて実行すると落ちる」という、一番読みにくい失敗の形になります。
対策は、テストごとに初期状態に戻すことです。 初期状態を別に持っておいて、各テストの前に書き戻します。この後片づけを1行足す、という決まりを最初に作っておきます。
つまずいたところ
1. 「必須」と書いてある記事を、疑わなかった
一番の遠回りがこれでした。
「Reactには状態管理ライブラリが必須」と読んで、何が問題なのかを確かめる前に入れました。 そして問題が起きていないのに解決策を入れたので、何が良くなったのかも分かりませんでした。
いま思えば、その記事が書かれた時期の問題もありました。 データ取得の道具が今ほど普及していなかった頃は、サーバーのデータも状態管理ライブラリに入れるのが普通でした。「必須」は、その時代には正しかったのだと思います。
古い記事が嘘なのではなく、前提が変わっていました。 「いつ書かれたか」を見るようになりました。
2. Zustand を入れたのに、速くならなかった
最初、こう書いていました。
const { theme } = useUiStore()
「動くから合っている」と思っていました。 Console の数字は、Context 版とまったく同じでした。
セレクタを渡していなかったからです。 引数なしで呼ぶと、ストア全体を購読します。
const theme = useUiStore((s) => s.theme)
この (s) => s.theme を書くために入れているライブラリでした。 書き忘れてもエラーは出ません。ただ遅いままです。
3. まとめて取り出したら、画面が落ちた
セレクタを覚えたので、こう書きました。
const { theme, sidebarOpen } = useUiStore((s) => ({ theme: s.theme, sidebarOpen: s.sidebarOpen }))
Maximum update depth exceeded で画面が落ちました。 毎回、新しいオブジェクトを作って返しているからです(v4 までは、全部再描画されるだけでした)。
Contextの回の value={{ a, b }} と、まったく同じ問題でした。 道具が変わっても、「毎回新しいオブジェクトを作ると、別物と判定される」というJavaScriptの性質は変わりません。
素直に2行に分けて解決しました。
4. ストアに useState の代わりをさせて、逆に読みにくくなった
セレクタが気持ちよかったので、モーダルの開閉やタブの選択も、次々にストアに移しました。
その画面でしか使わない状態まで、アプリ全体のストアに集まりました。 結果、uiStore.js が200行を超え、「この isEditing はどの画面のものか」が分からなくなりました。
1つの画面の中で完結する状態は、
useStateのままにします。 ストアに入れる基準は「遠い場所どうしが読み書きするか」であって、「便利かどうか」ではありません。
5. リロードするとテーマが戻る
当たり前でした。 ストアはメモリの中にあるので、リロードすれば消えます。
残したいなら、自分で保存します。 Zustand には persist というミドルウェアがあり、localStorage に自動で保存できます。
ただし、②の表を思い出してください。 「開いているタブ」を persist で保存するのは、URLに置くべきものを、間違った場所に永続化しているだけです。保存したくなったら、まず種類を疑います。
後片づけ
この記事の練習場を消します。 VMの中で実行します。
まず、npm run dev を止めます(Ctrl + C)。
確認: reactlab が消えていれば片づけ完了です。sudo ufw status に 5186/tcp が残っていないことも見ておきます。
消さずに残す場合は、
src/main.jsxのStrictModeを必ず戻してください。 ①で数を数えるために外しました。外したまま開発を続けると、StrictModeが見つけてくれるはずのバグを見逃します。
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'
createRoot(document.getElementById('root')).render(
<StrictMode>
<App />
</StrictMode>
)
戻し方: もう一度やりたくなったら、①の
npm create vite@latest reactlab -- --template reactからやるだけです。数分で戻せます(node_modulesは消してよい)。
まとめ
- 「Reactには状態管理ライブラリが必須」は、いまは正しくない。 前提が変わった古い記事が、そのまま残っている
- 入れる前に、状態を4種類に分ける。 サーバーのデータ / URLの状態 / フォームの入力 / 本当のクライアント状態
- 「ライブラリが要る」と思っているものの大半は、サーバーのデータ。 それはキャッシュの道具の担当で、状態管理の問題ではない
- サーバーのデータをストアに入れると、「いつ取り直すか」を全部自分で書くことになる
- URLの状態は、URLに置く。 ストアに置くと、リロードで戻り、戻るボタンが効かず、送ったリンクが別の画面を開く
- フォームの入力は、その画面から出さない。 全体のストアに置くと、1文字ごとに全員が再描画される
- 仕分けたあとに残るのは、4〜6本くらい。 テーマ・サイドバーの開閉・通知・認証情報
- 4〜6本なら、まず Context。 Context を分けるだけで足りることは多い
- Context の限界は1点だけ。セレクタが無いこと。 「この人には要らない」を判断できないので、値の数だけ Context が増える
- Zustand は
createでストアを1つ作るだけ。 値と更新関数を同じ場所に書く setは上書きではなくマージ。 返したキーだけが差し替わる- セレクタ
(s) => s.themeを書かないと、速くならない。 引数なしのuseUiStore()はストア全体の購読で、Context 版と同じ - セレクタでオブジェクトを作って返すと、v5 では無限ループで落ちることがある(v4 までは全部再描画)。行を分けるのが一番安全。まとめるなら
useShallow - Provider が要らない。 React の外からも
getState()で触れる。便利であり、危なくもある - 他の選択肢は「別の書き方」ではなく「別の考え方」。 中央集権(Redux Toolkit)/ 原子(Jotai)/ 監視(MobX)
- Redux Toolkit が売るのは短さではなく、制約。 全変更が action を通るので、履歴が追える。人数が多いときに効く
- 入れる前の3つ: 測って足りないと分かったか / サーバーのデータではないか / ルールに合意があるか
- 入れると仕事も増える。 変更元が追いにくくなる・DevTools を自分で繋ぐ・テストで状態を戻す
- 1画面で完結する状態を、ストアに移さない。 基準は「遠い場所どうしが読み書きするか」
- このサイトの方針: まず
useStateと Context で書く。困ったと測って分かってから Zustand。Redux Toolkit は、履歴を追う理由があるときだけ。
入れないことは、遅れていることではありません。
参考リンク
- roadmap.sh — React
- React 公式 — state の管理
- React 公式 — state 構造の選択
- React 公式 — Reducer と Context を組み合わせる
- React 公式 — useContext
- React 公式 — useSyncExternalStore
- Zustand 公式ドキュメント
- Zustand — テストの書き方
- Zustand — persist ミドルウェア
- Zustand — GitHub
- npm — zustand
- Redux Toolkit 公式
- Redux 公式 — スタイルガイド
- Redux DevTools
- Jotai 公式
- MobX 公式
- TanStack Query 公式
- React Router 公式
- MDN — URLSearchParams
- Vite 公式ドキュメント
次に読む
この記事は 【深掘り】React の 17 / 24 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | UIライブラリとヘッドレスUI — 自作モーダルはEscで閉じない |
| → 次の記事 | Reactのテスト — 実装を直すたびに落ちる |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- 状態を4種類に分けて、本当に残るものを数える
- Zustand とセレクタ
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント