Tree shaking («встряхивание дерева») — это оптимизация сборки, которая удаляет из итогового JavaScript-файла код, который никто не использует. Название — образное: встряхнули дерево зависимостей, и «мёртвые листья» отвалились.
Работает это так. Современные модули (import и export) позволяют сборщику заранее увидеть, какие функции реально импортируются. Если вы подключили библиотеку на 200 функций, а используете три, сборщик оставит в бандле только эти три и то, от чего они зависят. Меньше кода — быстрее загрузка и разбор страницы в браузере, лучше метрики вроде LCP из Core Web Vitals.
Tree shaking умеют Vite, Rollup, webpack, esbuild. Обычно он включается сам в боевой сборке.
Условия, при которых он работает
- Код написан на ES-модулях (
import/export), а не на старомrequire. - Библиотека собрана так, чтобы её части можно было импортировать по отдельности.
- В пакете указано, что у модулей нет побочных эффектов (поле
sideEffects: falseвpackage.json). - Запущена боевая сборка, а не режим разработки.
Типичные ошибки
- Импортируют библиотеку целиком:
import _ from 'lodash'вместоimport debounce from 'lodash/debounce'. - Берут пакеты в старом формате CommonJS, которые плохо поддаются разбору.
- Оставляют в модулях код с побочными эффектами, и сборщик боится его убрать.
- Никогда не смотрят состав бандла и не замечают тяжёлых зависимостей.
Как проверить
Откройте отчёт анализатора бандла (например, плагин для Vite или webpack) и посмотрите, какие пакеты занимают больше всего места. Сравните размер до и после изменений импортов.
Частый вопрос
Tree shaking уберёт весь лишний код автоматически? Не весь. Он удаляет только то, что сборщик может надёжно доказать неиспользуемым. Код с побочными эффектами и пакеты в старом формате остаются, поэтому размер бандла стоит проверять вручную.