React Compiler v1.0でuseMemoとuseCallbackを消す移行手順
React Compiler v1.0を既存プロジェクトに導入し、手書きのuseMemo・useCallbackを安全に削除するまでの手順と、消してはいけないケースを実体験ベースで解説する
React 19 のプロジェクトに React Compiler を入れて、手書きの useMemo と useCallback を片っ端から消していった。結論から言うと、9割は消せる。ただし残り1割を誤って消すと本番でループが回るので、順番が大事になる。
まず ESLint を通す。コンパイラより先に
コンパイラを有効にする前に、eslint-plugin-react-hooks v7 を入れる。v7 には React Compiler が内部で使うルール群(refs、set-state-in-render、purity など)が recommended プリセットに統合されている。
npm install --save-dev eslint-plugin-react-hooks@latest
// eslint.config.js
import reactHooks from 'eslint-plugin-react-hooks';
export default [reactHooks.configs.flat.recommended];
自分のプロジェクト(コンポーネント約120個)で回したら、警告が8件出た。内訳はレンダー中の setState が3件、ref への unsafe なアクセスが2件、props を直接 .sort() しているのが3件。これらはコンパイラを入れる前に直す。コンパイラは Rules of React に違反したコードを検出するとそのコンポーネントの最適化をスキップするので、ここを放置すると「入れたのに効いてない」という状態になる。
コンパイラを有効にする
React Compiler v1.0 は 2025年10月7日にリリースされた。ビルド時に動く Babel プラグインで、コンポーネントとフックを解析して自動でメモ化を挿入する。
npm install --save-dev --save-exact babel-plugin-react-compiler@latest
Next.js なら next.config.js に1行。
// next.config.js
const nextConfig = {
experimental: {
reactCompiler: true,
},
};
export default nextConfig;
Vite なら @vitejs/plugin-react の babel オプションに渡す。
// vite.config.ts
import react from '@vitejs/plugin-react';
export default defineConfig({
plugins: [
react({
babel: {
plugins: ['babel-plugin-react-compiler'],
},
}),
],
});
React 17・18 で使う場合は react-compiler-runtime パッケージが追加で必要になる。React 19 ならランタイムは不要。
有効にしたら React DevTools(v5.0以降)の Components タブを開く。コンパイラが処理したコンポーネントには「Memo ✨」バッジが付く。全コンポーネントに付いていなくても問題ない。コンパイラが安全に最適化できないと判断したものはスキップされるだけで、アプリは壊れない。
useMemo・useCallback を消す手順
ここが本題。一括置換で消したくなるが、やめたほうがいい。
手順は「1コンポーネントずつ」が鉄則。 理由は、コンパイラのメモ化境界と自分が手書きした境界が微妙にずれることがあるから。特に useEffect の deps に渡しているオブジェクトや関数は、参照の同一性が変わると Effect が再発火する。コンパイラが別の粒度でメモ化した結果、意図しないタイミングで Effect が走る可能性がある。
実際の作業フロー:
- DevTools で対象コンポーネントに「Memo ✨」バッジがあることを確認する
- そのコンポーネント内の
useMemo/useCallbackを1つ消す - 開発環境で該当画面を触り、挙動が変わっていないことを確認する
- E2E テストがあればそこも通す
- 次のコンポーネントへ
自分は120コンポーネント中、useMemo が34箇所、useCallback が28箇所あった。このうち消せたのは合計55箇所。残した7箇所はすべて「消すと壊れた」パターンに該当した。
消してはいけないケース
以下のパターンは手動メモ化を残す。
1. Effect の deps に渡しているオブジェクト・関数
// これは消さない
const options = useMemo(() => ({ endpoint, timeout }), [endpoint, timeout]);
useEffect(() => {
connect(options);
return () => disconnect();
}, [options]);
コンパイラの自動メモ化でも結果は同じになる はず だが、Effect の再発火はバグとして表面化しにくい(ログに出ない限り気づけない)。安全側に倒すなら残す。
2. サードパーティライブラリがコールバックの参照同一性に依存している場合
React Hook Form の watch()、Chart.js のクリックハンドラ、Canvas 系ライブラリのイベント登録など。自分のプロジェクトでは React Hook Form 周りで問題が出た。コンパイラを有効にした状態で useForm() の返り値を使うと watch() のリアクティブ更新が止まるケースがあり、"use no memo" ディレクティブでそのコンポーネントだけオプトアウトした。
function UserForm() {
"use no memo";
const { register, watch } = useForm();
// ...
}
"use no memo" は関数の先頭に書く。そのコンポーネント(またはフック)だけコンパイラの対象外になる。あくまで一時的な回避策という位置づけなので、ライブラリ側が対応したら外す。
3. props を直接 mutate しているコード
// NG: コンパイラは純粋関数を前提にしている
function OrderList({ orders }) {
const sorted = orders.sort((a, b) => a.date - b.date); // 元配列を破壊
// ...
}
これは useMemo を残す・消す以前の問題で、コンパイラが正しく動かない。.toSorted() に書き換えるか、スプレッドしてからソートする。
codemod で一括削除する選択肢
手作業が嫌なら react-compiler-unmemo という codemod がある。useMemo と useCallback を構文解析ベースで除去してくれる。正規表現ではなくパーサーを使っているので、ネストしたジェネリクスや複数行のフックも壊さずに処理できるとされている。
ただし自分は使わなかった。codemod は「消すべきでないもの」を判断してくれないので、結局1箇所ずつ確認する工程は省けない。コンポーネント数が数百を超えるプロジェクトなら検討する価値はあると思う。
コンパイラ導入後のパフォーマンス変化
手元のプロジェクト(Next.js 15、React 19、コンポーネント約120個)でLighthouseを回した体感としては、INP が体感で2〜3割改善した。Meta の公式発表では初回ロードとページ遷移が最大12%高速化、一部のインタラクションは2.5倍速くなったとされている。
それよりも大きかったのはコードの見通しが良くなったこと。useMemo と useCallback が減ると、コンポーネントの本質的なロジックが読みやすくなる。レビューで「この deps 合ってる?」というやり取りがなくなっただけでも十分元は取れた。
検証環境: macOS 14 / Node.js 22 / Next.js 15.3 / React 19 / babel-plugin-react-compiler 1.0.x / 検証日 2026年9月