Что такое…

Что такое бандлер — и почему сайт приходится «собирать» перед запуском

Иллюстрация: сотни мелких деталей на конвейере сходятся в три аккуратных свёртка

Смотри, странная штука. Ты пишешь первую строчку import { useState } from 'react', открываешь свой index.html двойным кликом — и получаешь пустой белый экран с ошибкой в консоли.

Браузер не нашёл react. И он прав: файла с таким именем на диске нет. Есть папка node_modules, а в ней — тысячи файлов, разложенных по своей логике. Между «как удобно писать людям» и «что умеет браузер» лежит пропасть. Бандлер — это мост через неё.

Браузер не знает, где лежит react

Когда ты пишешь import ... from 'react', ты пишешь имя пакета, а не путь к файлу. Для тебя это очевидно: «возьми тот react, который я поставил». Для браузера — нет. Браузер умеет открывать только конкретные адреса: ./utils.js, /scripts/app.js, ссылку на другой сайт. Слово react для него не адрес.

Вторая проблема — количество. Один скромный проект тянет за собой сотни, а то и тысячи файлов из node_modules. Если бы браузер честно скачивал каждый по отдельности, страница открывалась бы минуту.

Третья — форматы. Часть библиотек написана в старом формате модулей, часть в новом, кто-то пишет на TypeScript или JSX, которых браузер не понимает вообще.

Бандлер решает все три разом.

Что бандлер делает за эти секунды

Когда ты запускаешь npm run build, за несколько секунд происходит примерно это:

  • Разворачивает импорты. Находит, что react — вот этот конкретный файл в node_modules, и подставляет реальные пути. Так он проходит по всей цепочке: твой файл → библиотека → её зависимости.
  • Склеивает. Тысяча файлов превращается в несколько — обычно один-два скрипта и стили.
  • Переводит. JSX и TypeScript становятся обычным JavaScript, который понимает браузер.
  • Выкидывает лишнее. Импортировал из библиотеки одну функцию из ста — в сборку поедет только она. Это называется tree-shaking, «отряхивание дерева».
  • Ужимает. Удаляет пробелы и комментарии, переименовывает длинные внутренние имена в однобуквенные.

На выходе — папка dist (или build). Внутри лежит готовый сайт: HTML, пара JS-файлов и стили. Это и есть то, что ты заливаешь на хостинг.

Почему dev-сервер мгновенный, а build долгий

Это первое, что сбивает с толку. npm run dev поднимается за полсекунды, а npm run build может думать полминуты — хотя код тот же самый.

Причина в том, что это два разных режима работы.

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

В режиме сборки задача обратная: не «быстро показать разработчику», а «сделать так, чтобы у пользователя грузилось за миллисекунды». Тут уже нужно пройтись по всему проекту целиком, всё склеить, ужать и оптимизировать. Это честная тяжёлая работа, и она разовая.

Зачем это тебе на практике

Три вещи, которые перестанут быть магией.

Странные имена файлов. В dist ты увидишь index-a3f8c1.js вместо index.js. Эти буквы — отпечаток содержимого. Изменил код — отпечаток другой — браузер пользователя видит новый адрес и скачивает свежий файл. Не изменил — адрес прежний, файл берётся из кэша. Именно поэтому у людей не залипает старая версия сайта.

«У меня работает, а на сервере белый экран». Очень часто это значит, что ты открывал проект через dev-сервер, а собранную версию ни разу не проверял. Правило: перед деплоем запусти сборку и открой её локально — половина сюрпризов ловится там.

Ошибки сборки — это не ошибки кода. Если build падает, а dev работал, дело обычно в том, что в режиме сборки включаются строгие проверки, которые dev-сервер пропускал.

Vite, webpack, Turbopack — это всё бандлеры?

Да, это конкуренты в одной нише. webpack — ветеран, до сих пор крутится в тысячах старых проектов. Vite — то, с чего сегодня начинают новые. Turbopack — бандлер внутри Next.js, там он теперь работает по умолчанию. Что выбрать под свой проект, разбираем отдельно в Next.js или Vite.

Заметная примета последних лет: их массово переписывают на Rust ради скорости. Turbopack на Rust изначально, а Vite восьмой версии перешёл на новый движок Rolldown — тоже на Rust — и заменил им сразу две прежние части. Практический вывод для тебя простой: если сборка проекта раздражающе медленная, возможно, дело не в твоём коде, а в возрасте инструмента.

Можно обойтись без бандлера?

Для маленькой странички — да. Если ты пишешь на чистом HTML, CSS и JS без библиотек, никакая сборка не нужна: браузер откроет файлы как есть. В браузерах есть и «карты импортов» (import maps), которые позволяют объяснить браузеру, где искать react, без сборки вообще. Но как только появляются десятки зависимостей, TypeScript или React — ручной труд перестаёт окупаться.

Что делать, если сборка падает с ошибкой?

Читай первую ошибку, а не последнюю: остальные обычно её последствия. Она почти всегда называет файл и строку. Если там жалоба на модуль, которого «нет», сперва проверь, установлен ли пакет — часто помогает простая переустановка зависимостей через npm.

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

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

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

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

Все статьи →