Что такое…

Что такое tree shaking — и почему lodash всё равно едет в бандл целиком

Иллюстрация: с дерева осыпаются сухие ветки, остаётся только живое

Ты берёшь из библиотеки одну функцию — скажем, debounce. Пишешь честный именованный импорт. Открываешь готовую сборку и находишь там всю библиотеку целиком, все триста функций.

Механизм, который должен был это вычистить, называется tree shaking. И у него есть условие, о котором почти нигде не пишут: он работает не со всеми пакетами. С самыми популярными — часто не работает вовсе.

Что это такое в одну строку

Tree shaking — это «вытряхивание сухих веток»: сборщик проходит по коду от точки входа и выбрасывает всё, до чего не дотянулись импорты. Термин пришёл из сборщика Rollup, сейчас так умеют все.

Идея простая. Ты импортировал две функции из библиотеки на триста — в бандл должны попасть две. Проблема в том, что «дотянулись импорты» сборщику надо доказать, не запуская код. А доказать это можно не всегда.

Почему всё упирается в формат модулей

Есть два способа подключать чужой код.

Современный, ESM — это import и export. Ключевое свойство: список того, что модуль отдаёт и что берёт, написан в тексте файла и не может измениться во время работы. Сборщик читает файл и точно знает граф зависимостей.

Старый, CommonJS — это require(). А require — обычный вызов функции. Его можно спрятать в if, собрать имя модуля из переменной, положить в цикл. Сборщик не может доказать, что именно оттуда используется, — и не рискует. Оставляет всё.

Отсюда и история с lodash. Основной пакет lodash собран в CommonJS: в его package.json нет ни "type": "module", ни поля module. Ты пишешь именованный импорт, а вытряхнуть нечего — формат не позволяет. Распакованный пакет весит около 1,4 МБ и содержит больше тысячи файлов.

Рядом на npm лежит lodash-es — та же библиотека, той же версии, но в ESM. Распакованная — около 635 КБ, и в package.json явно написано "sideEffects": false. Вот из неё сборщик достаёт ровно debounce.

Побочные эффекты — вторая причина промаха

Даже с честным ESM сборщик иногда не решается выбросить модуль. Причина — побочные эффекты.

Побочный эффект — это когда файл при импорте что-то делает, а не просто отдаёт функции. Полифил, который дописывает метод глобальному объекту. Файл стилей. Регистрация чего-нибудь в глобальном реестре. Выкинешь такой модуль как «неиспользуемый» — сломаешь приложение.

Сборщик про твой код этого не знает, поэтому осторожничает. Подсказать ему можно строкой в package.json:

{ "sideEffects": false }

Это обещание: «во всех моих файлах импорт ничего не делает, кроме экспорта». Если эффекты всё-таки есть, вместо false пишут список файлов:

{ "sideEffects": ["./src/polyfill.js", "*.css"] }

CSS в этом списке — самая частая забытая строчка. Стили импортируются ради самого эффекта, экспортов у них нет, и без пометки они молча выпадают из production-сборки. Классический баг «локально всё красиво, а на проде без стилей».

Три проверки перед установкой пакета

Это и есть практический выхлоп. Открываешь страницу пакета на npm, смотришь package.json:

  1. Есть ли "type": "module" или поле module? Нет ни того ни другого — пакет в CommonJS, вытряхиваться не будет. Ищи ESM-вариант: часто он лежит рядом с суффиксом -es или уже встроен через поле exports, как у date-fns.
  2. Есть ли "sideEffects": false? Есть — автор сделал работу за тебя, сборщик сможет пропускать целые файлы. Это работает эффективнее, чем анализ отдельных выражений.
  3. Как ты импортируешь? import { debounce } from "lodash-es" — можно вытряхнуть. Импорт «всего пакета одним объектом» — почти никогда.

И четвёртое, не про пакет, а про тебя: tree shaking включается только в production-сборке. В режиме разработки его нет специально — иначе отладка стала бы адом. Не пугайся размеру файла в npm run dev и не сравнивай его с продовым; как измерить правильно — в гайде, как уменьшить JavaScript-бандл.

Надо ли что-то включать в сборщике?

Нет. Vite, webpack и Rollup вытряхивают код сами при сборке в production. От тебя нужны ESM-пакеты и именованные импорты — настройки тут почти ни при чём.

Почему после перехода на ESM бандл почти не похудел?

Скорее всего, дело в побочных эффектах: в пакете нет "sideEffects": false, и сборщик не рискует выбрасывать модули целиком. Второй частый вариант — какой-то плагин или пресет по дороге превращает твой ESM обратно в CommonJS.

Это то же самое, что минификация?

Нет. Минификация укорачивает то, что уже решено оставить. Tree shaking решает, что вообще оставлять. Работают по очереди: сначала вытряхивание, потом минификация, и только потом сжатие при передаче.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →