Что такое…

Что такое code splitting — и почему главная тащит код, который никто не откроет

Иллюстрация: один тяжёлый ящик распадается на несколько лёгких

Открой любое приложение, которое ты собрал: главная страница, форма входа, две кнопки. А в браузер приезжает файл на пару мегабайт.

Потому что там внутри лежит всё: редактор текста со страницы «Создать», библиотека графиков со страницы «Статистика», админка, календарь. Человек зашёл почитать главную — и скачал код, который никогда не откроет. Code splitting чинит именно это.

Почему по умолчанию всё в одном файле

Когда ты пишешь обычный импорт:

import Chart from "chart.js";

сборщик понимает это буквально: «этот модуль нужен, чтобы программа запустилась». Он идёт по цепочке импортов от точки входа, собирает всё, до чего дотянулся, и складывает в один файл. Даже если Chart вызывается один раз, на странице, куда заходит один человек из ста.

Это разумное поведение по умолчанию: один запрос вместо сотни, всё на месте, ничего не сломается. Плохо становится, когда приложение выросло.

Одна конструкция, которая всё меняет

Динамический импорт — обычный импорт со скобками:

const { default: Chart } = await import("chart.js");

Разница принципиальная. Сборщик видит скобки и понимает: этот модуль нужен не сразу. Он вырезает его вместе со всеми зависимостями в отдельный файл — чанк — и оставляет в основном бандле только маленькую заглушку. Файл поедет по сети в тот момент, когда выполнится строка с await.

Конструкция возвращает промис, а не значение: код придётся написать асинхронным. Работает во всех браузерах с января 2020 года, отдельная библиотека не нужна.

Одно исключение, о которое спотыкаются: внутри service worker динамический импорт запрещён и бросает ошибку. Там всё должно быть загружено заранее.

Где резать, чтобы это окупилось

Не по компонентам. По моментам, когда человек делает выбор.

По маршрутам. Самый большой выигрыш при самой простой правке. Страница «Статистика» — отдельный чанк, «Настройки» — отдельный. Человек на главной не платит ни за одну из них. Во фреймворках с файловой маршрутизацией это часто уже включено — проверь, а не переделывай.

По тяжёлым виджетам. Карта, редактор кода, экспорт в PDF, распознавание речи. Обычно это самые жирные библиотеки в проекте, и открывает их меньшинство. Грузи по клику на кнопку.

По условию. Панель администратора нужна одному аккаунту из тысячи. Отладочная панель — только в разработке. Такое проверяется одним if вокруг динамического импорта.

Почему «разрезать всё» — плохая идея

Здесь неочевидная часть. Может показаться, что чем мельче куски, тем лучше. Наоборот.

Документация MDN говорит об этом прямо: динамический импорт стоит использовать только там, где он нужен, а статическая форма предпочтительнее — потому что она лучше поддаётся статическому анализу и tree shaking. Разрезав модуль на чанк, ты прячешь его от анализатора: сборщик уже не может доказать, какие куски внутри не используются, и вычистить их. Подробнее про этот механизм — в разборе, что такое tree shaking.

Вторая беда — водопад. Чанк не может начать грузиться, пока не выполнился код, который его запросил. Три уровня вложенных динамических импортов = три последовательных похода в сеть вместо одного. На мобильном интернете это заметнее, чем лишние 40 КБ, которые ты сэкономил.

Что человек видит, пока чанк едет

Это не бесплатно: между кликом и появлением экрана возникает пауза. Три вещи, которые её прячут:

  • Заглушка на месте будущего блока — скелетон или спиннер. Главное, чтобы она занимала столько же места, иначе вёрстка прыгнет.
  • Предзагрузка на наведение: наводит мышь на пункт меню — начинаем качать чанк, ещё до клика.
  • Обработка ошибки. Промис динамического импорта отклоняется, если сети нет или файл не нашёлся. Без catch человек получит зависший экран без объяснений.

Как найти, что именно резать в твоём проекте, — пошагово в гайде, как уменьшить JavaScript-бандл.

Code splitting и tree shaking — это одно и то же?

Нет, они решают разные задачи. Tree shaking выкидывает код, который никому не нужен. Code splitting откладывает код, который нужен, но не прямо сейчас. Работают вместе, но заменить друг друга не могут.

Библиотека, нужная на двух страницах, скачается дважды?

Нет. Сборщик видит, что модуль требуется двум чанкам, и выносит его в третий, общий. Он приедет один раз — при первом заходе на любую из этих страниц, — а дальше возьмётся из кэша браузера. Ровно поэтому не стоит собирать «вендорный» чанк вручную: список пакетов, написанный человеком, почти всегда раскладывается хуже, чем то, что сборщик посчитает сам.

Нужен ли сплит маленькому сайту?

Обычно нет. Если весь твой JavaScript весит меньше сотни килобайт, разрезать его — только добавить запросов. Начинай, когда бандл переваливает за пару сотен килобайт или когда в проекте появилась одна очевидно тяжёлая библиотека.

Надо ли настраивать сборщик руками?

Нет. И Vite, и webpack, и Rollup создают отдельный чанк на каждый динамический импорт сами — от тебя нужны только скобки в нужном месте.

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

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

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

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

Все статьи →