Гайды

Как уменьшить 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 коротких урока на телефоне.

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

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

Все статьи →