Как уменьшить JavaScript-бандл — 6 шагов и команда, с которой начинают

Сайт открывается вяло, а картинки ты уже сжал. Значит, очередь дошла до JavaScript: браузеру мало его скачать — файл ещё нужно разобрать и выполнить, и всё это время страница не отвечает на нажатия.
Хорошая новость: почти всегда виноваты две-три конкретные зависимости, а не «код вообще». Ниже — как их найти и что с ними сделать. Порядок важен: сначала измеряем, потом режем.
Шаг 1. Узнай настоящую цифру
Размер файла из npm run dev не значит ничего: в режиме разработки сборщик специально не оптимизирует. Мерить надо продовую сборку.
npm run build
Сборщик напечатает список файлов и их размеры — часто сразу в двух колонках: как есть и после сжатия. Запиши обе цифры, в конце сравнишь.
Ориентир: если весь JavaScript после сжатия влезает в 100–150 КБ, ты в порядке и дальше можно не читать. Дальше начинается интересное.
Шаг 2. Посмотри, из чего он состоит
Это ключевой шаг, и он делается одной командой. Карта сборки показывает прямоугольники: чем больше площадь, тем больше пакет весит в твоём бандле.
Для Vite:
npx vite-bundle-visualizer
Для webpack — плагин webpack-bundle-analyzer. Универсальный вариант, работающий по уже собранным файлам, если рядом лежат карты кода:
npx source-map-explorer dist/assets/*.js
Откроется картинка, и обычно там сразу видно неприятное: половину площади занимает один пакет, о котором ты и не думал. Библиотека дат целиком. Набор иконок, из которого ты используешь четыре. Библиотека графиков ради одного круга.
Шаг 3. Разберись с самым большим прямоугольником
Только с одним — самым крупным. Три варианта решения, по возрастанию усилий:
- Импортировать иначе. Часто пакет тащится целиком из-за формата или из-за импорта «всего объекта». Проверь, есть ли рядом ESM-версия и именованные импорты — механика подробно разобрана в статье, что такое tree shaking.
- Заменить на лёгкое. У большинства тяжёлых библиотек есть современный компактный аналог. Форматирование дат, запросы к сети, работа с классами CSS — почти всё это сегодня либо есть в браузере, либо весит в разы меньше.
- Выкинуть. Самый недооценённый вариант. Пакет, из которого ты используешь одну функцию на пятнадцать строк, честнее переписать у себя.
Повтори шаги 2–3 ещё раз. Обычно двух заходов хватает, чтобы срезать основное.
Шаг 4. Проверь, что выполняется, а не только что весит
В Chrome открой DevTools, нажми Ctrl+Shift+P и набери «Coverage». Появится панель покрытия: перезагрузи страницу и посмотри, какая доля скачанного кода вообще выполнилась.
Красная полоса на 70% у файла означает: человек скачал и разобрал код, который на этой странице не понадобился. Это и есть список кандидатов на следующий шаг.
Шаг 5. Вынеси редкое в отдельные чанки
Всё, что нужно не при первой загрузке, переводим на динамический импорт:
const { default: Chart } = await import("chart.js");
Сборщик сам вырежет это в отдельный файл, который поедет по сети только при вызове. Резать стоит по маршрутам и по тяжёлым виджетам — карта, редактор, экспорт в PDF. Где сплит окупается, а где делает хуже, разобрано в статье, что такое code splitting.
Важно не увлечься: каждый чанк — это дополнительный поход в сеть, и цепочка из трёх вложенных импортов может оказаться медленнее одного файла.
Шаг 6. Включи сжатие и перемерь
Последний шаг — не про твой код, а про сервер. Проверь, что файлы уезжают сжатыми: открой вкладку Network, кликни на JS-файл и найди в заголовках ответа content-encoding со значением br или gzip. Нет заголовка — ты отдаёшь текст в полный размер, а это самый дешёвый выигрыш из всех. Чем эти два способа отличаются от минификации — в разборе, минификация или сжатие.
Теперь повтори шаг 1 и сравни с записанным.
Что получится
Порядок величин на типовом проекте, где раньше не занимались размером:
- Шаг 3 (одна тяжёлая зависимость) — обычно самый крупный выигрыш, десятки процентов бандла.
- Шаг 5 (маршруты в отдельных чанках) — первая загрузка становится заметно легче, общий объём тот же.
- Шаг 6 (сжатие на сервере) — текст ужимается в разы, настраивается один раз и навсегда.
И главное, что меняется не в цифрах: страница начинает отзываться на нажатия сразу, а не через паузу, пока браузер дожёвывает скрипт.
С какого размера вообще стоит этим заниматься?
Пока продовый JavaScript влезает в 100–150 КБ после сжатия — не стоит. Дальше каждая сотня килобайт заметна на среднем телефоне.
Почему у меня после сборки десятки файлов вместо одного?
Так и должно быть: сборщик сам делит код на общий кусок и куски под страницы. Много мелких файлов — не проблема, если их не сотни и они не выстроены в цепочку.
Что делать, если тяжёлый пакет заменить нечем?
Оставь его, но не в первой загрузке: заверни в динамический импорт и покажи заглушку на время. Человек заплатит за него, только если действительно откроет тот экран.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





