Что такое 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:
- Есть ли
"type": "module"или полеmodule? Нет ни того ни другого — пакет в CommonJS, вытряхиваться не будет. Ищи ESM-вариант: часто он лежит рядом с суффиксом-esили уже встроен через полеexports, как уdate-fns. - Есть ли
"sideEffects": false? Есть — автор сделал работу за тебя, сборщик сможет пропускать целые файлы. Это работает эффективнее, чем анализ отдельных выражений. - Как ты импортируешь?
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 коротких урока на телефоне.





