re:re:actable
Урок 084 минуты чтения

React Compiler: как он работает и что меняет в коде

На этой странице
Кратко

React Compiler (1.0 — октябрь 2025) — плагин сборки, который анализирует компоненты и хуки и автоматически мемоизирует JSX, вычисления и функции. Он делает работу memo, useMemo и useCallback, но гранулярнее: кэширует отдельные выражения, даже внутри условных веток. Компилятор оптимизирует только код, который соблюдает правила React (чистый рендер, иммутабельность props и state, правила хуков); остальное он безопасно пропускает. Подключение: Babel-плагин babel-plugin-react-compiler (Vite и др.), reactCompiler: true в Next.js (в Next 16.3+ есть экспериментальная Rust-версия внутри Turbopack). Нарушения подсвечивает eslint-plugin-react-hooks. Работает с React 19, а с React 17–18 — через react-compiler-runtime. Компилятор убирает лишние ререндеры, но не решает проблемы архитектуры, сети и тяжёлых вычислений.

Вопрос

Что такое React Compiler? Как он работает, как его подключить и нужны ли теперь useMemo и useCallback?

Что было до компилятора

const BookRow = memo(function BookRow({ book, onSelect }) { /* ... */ });
 
function BookList({ books, query, onSelect }) {
  const visible = useMemo(() => books.filter((b) => b.title.includes(query)), [books, query]);
  const handleSelect = useCallback((id) => onSelect(id), [onSelect]);
  return visible.map((b) => <BookRow key={b.id} book={b} onSelect={handleSelect} />);
}

Три вида ручной мемоизации, которые легко забыть или сломать одним новым объектом в props.

С компилятором

function BookRow({ book, onSelect }) { /* ... */ }
 
function BookList({ books, query, onSelect }) {
  const visible = books.filter((b) => b.title.includes(query));
  const handleSelect = (id) => onSelect(id);
  return visible.map((b) => <BookRow key={b.id} book={b} onSelect={handleSelect} />);
}

На выходе компилятор генерирует код с кэшем на уровне компонента (упрощённо):

function BookList({ books, query, onSelect }) {
  const $ = _c(6);               // массив-кэш этого экземпляра
  let visible;
  if ($[0] !== books || $[1] !== query) {
    visible = books.filter((b) => b.title.includes(query));
    $[0] = books; $[1] = query; $[2] = visible;
  } else {
    visible = $[2];
  }
  // аналогично: handleSelect зависит от onSelect, JSX — от visible и handleSelect
}

Если входы не изменились, компонент вернёт тот же JSX-объект, и React пропустит поддерево — как с memo, но автоматически.

Подключение

// next.config.ts
const nextConfig: NextConfig = {
  reactCompiler: true,
  // experimental: { turbopackRustReactCompiler: true }, // Next 16.3+: Rust-версия, быстрее Babel
};
// vite.config.ts
export default defineConfig({
  plugins: [react({ babel: { plugins: ['babel-plugin-react-compiler'] } })],
});
npm i -D babel-plugin-react-compiler eslint-plugin-react-hooks@latest

Что мешает оптимизации

function Bad({ books }) {
  books.sort();                       // ✗ мутация props
  const counter = useRef(0);
  counter.current++;                  // ✗ запись в ref во время рендера
  window.lastRendered = Date.now();   // ✗ побочный эффект в рендере
  return <List items={books} />;
}

Такие компоненты компилятор не трогает, а ESLint (react-hooks/purity, react-hooks/immutability, react-hooks/refs и др. в пресете recommended) указывает на нарушение. Исправление — сделать рендер чистым: books.toSorted(), эффект для записи в window, состояние вместо ref для отображаемых данных.

Постепенное внедрение

reactCompiler: { compilationMode: 'annotation' } // только компоненты с "use memo"
function Dashboard() {
  'use memo';     // включить для этого компонента
}
function LegacyChart() {
  'use no memo';  // временно выключить, если что-то сломалось
}

Проверка: в React DevTools оптимизированные компоненты помечены бейджем Memo ✨; в Profiler видно, что лишние поддеревья перестали рендериться.

Нужны ли useMemo и useCallback

СитуацияРекомендация
Новый код с компиляторомНе писать ручную мемоизацию «на всякий случай»
Существующие useMemo/useCallbackМожно оставить; удалять постепенно, с тестами
Значение — зависимость эффекта, нужна точная стабильностьРучная мемоизация допустима как явный контроль
Проект без компилятораМемоизация по данным профайлера

Чего компилятор не делает

  • Не уменьшает бандл и не ускоряет сеть.
  • Не ускоряет вычисление, которое меняется каждый раз.
  • Не заменяет виртуализацию длинных списков и useTransition для тяжёлого рендера.
  • Не исправляет архитектуру: глобальный контекст с частыми обновлениями всё ещё ререндерит потребителей.

Мини-шпаргалка

Compiler = автоматические memo/useMemo/useCallback при сборке
Только для «правильного» React: чистый рендер, иммутабельность, правила хуков
Next: reactCompiler: true · Vite: babel-plugin-react-compiler
ESLint: eslint-plugin-react-hooks (recommended)
"use memo" / "use no memo", compilationMode: 'annotation'
DevTools: бейдж Memo ✨

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам