Почему сборка идёт вечность — 3 причины, которые чинятся за вечер

Ты правишь одну строку в тексте кнопки. Жмёшь деплой. И ждёшь восемь минут.
Обиднее всего, что чинится это обычно за вечер — просто почти все начинают чинить не с того конца. Разберём три причины по частоте, но сначала — про измерение, потому что без него ты будешь оптимизировать не то.
Симптом
npm run build или сборка на сервере идёт минутами, хотя проект небольшой. Локально бывает быстрее, чем в CI, — или наоборот. Со временем становится всё хуже.
Сначала измерь, где уходят секунды
Главная ошибка — начать «оптимизировать сборку» вслепую. Люди выкидывают библиотеки и правят конфиги, а восемь минут из десяти всё это время уходили на установку зависимостей.
Открой лог сборки и посмотри на отметки времени между шагами. Практически любой CI печатает длительность каждого шага, а локально хватит time:
time npm ci
time npm run build
Два числа — и ты уже знаешь, куда смотреть. Если долго первое — тебе в причину 1. Если второе — в причины 2 и 3.
Причина 1. Нет кэша зависимостей (самая частая)
Локально ты ставишь пакеты один раз и забываешь. А сервер сборки каждый раз стартует с чистого листа: скачивает сотни мегабайт node_modules заново при каждом пуше. Вот твои минуты.
Как проверить. Найди в логе шаг установки зависимостей и посмотри его длительность. Больше минуты — почти наверняка кэша нет. Ещё признак: в логе видно, как пакеты тянутся из сети, а не берутся из кэша.
Как починить. Включить кэширование по lock-файлу. В GitHub Actions это одна строка в настройке окружения:
- uses: actions/setup-node@v4
with:
node-version: 22
cache: 'npm'
Ключ кэша считается от package-lock.json: зависимости не менялись — кэш переиспользуется, изменились — пересобирается. У других платформ есть свой аналог, ищи слово cache в их документации. Заодно проверь, что в CI ты зовёшь npm ci, а не npm install: первая команда быстрее и ставит строго то, что записано в lock-файле — про её отличия есть разбор ошибок npm install.
Если сборка идёт через Docker, причина та же, но в профиль: слои кэшируются по порядку. Копируй сначала package.json и lock-файл, ставь зависимости, и только потом копируй остальной код — тогда правка одной строки в коде не будет сбрасывать слой с зависимостями.
Причина 2. Ты собираешь то, что не нужно
Вторая по частоте — сборщик честно перемалывает файлы, которые в результат вообще не попадут.
Как проверить. Посмотри на размер папки, которая уходит в сборку, и на размер результата:
du -sh . --exclude=node_modules
du -sh dist
Если на входе сотни мегабайт, а на выходе пара — сборщик читает мусор.
Как починить:
- Исключи лишнее. Файл
.dockerignore(и.gitignore) должен содержатьnode_modules,.git, папку сборки, картинки исходников. Без.dockerignoreв образ уезжает вообще всё, включая локальныеnode_modules— и это медленно и бессмысленно. - Выключи source maps в проде. Они нужны для отладки, а генерируются долго и весят много. В большинстве сборщиков это один флаг.
- Не гоняй проверки дважды. Если линтер и тесты уже отработали отдельным шагом CI, незачем встраивать их ещё и в сборку.
Причина 3. Одна тяжёлая зависимость или импорт «всей библиотеки»
Третья причина тише остальных: сборка медленно тяжелеет по мере роста проекта.
Виноват обычно импорт целого пакета ради одной функции:
import _ from 'lodash' // тянет всю библиотеку
import debounce from 'lodash/debounce' // тянет одну функцию
Сборщик обязан разобрать весь пакет, даже если ты взял из него одну строчку. Пара таких импортов — и минута сверху.
Как проверить. Посмотри, что занимает место в результате. У большинства сборщиков есть флаг или плагин для отчёта о размере бандла; самый простой способ — отсортировать файлы результата по размеру и найти неожиданно жирные.
Как починить: импортировать конкретное, а не пакет целиком; выкинуть библиотеки, из которых ты используешь одну функцию (moment, целиком подключённые UI-киты — типичные подозреваемые); проверить package.json на зависимости, которые давно не нужны.
Отдельный пункт для TypeScript: проверка типов при каждой сборке легко съедает половину времени. Многие сборщики умеют собирать без неё, а типы проверять отдельным шагом параллельно — так общее время падает почти вдвое.
Если ничего из этого не помогло
Проверь, не собираешь ли ты в CI на самом слабом бесплатном раннере, и не запускается ли сборка по несколько раз на один пуш (частая история при связке нескольких workflow). Иногда «медленная сборка» — это три сборки, стоящие в очереди друг за другом.
Почему в CI дольше, чем локально?
Потому что локально у тебя уже есть кэш, зависимости и прогретый диск, а CI каждый раз начинает с нуля на машине послабее. Разница в 2–3 раза нормальна; в 10 раз — это отсутствие кэша.
Собирать быстрее — значит хуже?
Нет. Всё перечисленное убирает лишнюю работу, а не качество: кэш не меняет результат, .dockerignore выкидывает то, что и так не нужно, точечный импорт даёт тот же код. Единственный осознанный компромисс — source maps: без них отлаживать прод сложнее, поэтому многие оставляют их, но не публикуют.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





