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 ✨