---
title: "Системы сборки"
description: "Многие гениальные вещи создаются из лени. Системы сборки облегчают жизнь разработчика."
url: "https://doka.guide/tools/bundlers/"
section: "Веб-платформа"
createdAt: "2021-07-16"
updatedAt: "2023-01-25"
authors: ["igorkamyshev"]
contributors: ["furtivite"]
editors: ["tachisis"]
related: ["js/language-versions", "tools/static-analysis", "tools/web-app-types"]
source: "https://github.com/doka-guide/content/blob/main/tools/bundlers/index.md"
license: "CC BY-NC-SA 4.0"
---

# Системы сборки

## Кратко

Бандлер — программа, которая упаковывает сложный проект со многими файлами и внешними зависимостями в один (иногда несколько) файл, который будет отправлен браузеру.

Самый популярный бандлер — **[Webpack](/tools/webpack/)**, он используется в сложных проектах с высокими требованиями к конфигурируемости. Самый простой в использовании — **Parcel**, он хорошо подходит для небольших проектов без особенных требований.

## Как понять

Современные проекты могут быть огромными (100 тысяч строк или даже больше), писать такие объёмы кода в одном файле совершенно невозможно. К тому же, часто нужно использовать [готовые библиотеки](/tools/package-managers/), которые написал кто-то другой. Но, к сожалению, браузеры не очень хорошо поддерживают [проекты из многих файлов](/js/modules/). Из-за этого были придуманы **системы сборки** (их ещё называют бандлерами или сборщиками).

## Как пользоваться

Большинство бандлеров распространяются через _[npm](/tools/package-managers/)_. Чтобы начать ими пользоваться, достаточно добавить соответствующий пакет.

```bash
npm init
npm install parcel
```

Теперь нужно создать HTML-файл, в котором описать относительные пути до JavaScript-файлов, и запустить бандлер. Он сделает всю остальную работу.

```html
<!-- index.html -->
<html>
  <head>
    <title>Hello, bundler!</title>
  

<script>
  (function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
  m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
  (window, document, "script", "https://cdn.jsdelivr.net/npm/yandex-metrica-watch/tag.js", "ym")

  ym(83244811, "init", {
    clickmap:true,
    trackLinks:true,
    accurateTrackBounce:true
  })
</script>
<noscript><img src="https://mc.yandex.ru/watch/83244811" style="position:absolute;left:-9999px" alt=""></noscript>
<script async src="https://www.googletagmanager.com/gtag/js?id=G-GH8FX28ET0"></script>
<script>
  window.dataLayer = window.dataLayer || []
  function gtag(){dataLayer.push(arguments)}
  gtag("js", new Date())
  gtag("config", "G-GH8FX28ET0")
</script>
</head>
  <body>
    <h1 id="title">Hello, bundler!</h1>

    <script src="https://doka.guide/tools/bundlers/./index.js"></script>
  </body>
</html>
```

Рядом с этим файлом следует разместить JavaScript-файл:

```js
// index.js

document.getElementById('title').innerText = 'Hello from JS!'
```

Теперь можно запустить бандлер и посмотреть на результат в браузере. Для этого нужно добавить новый скрипт в `package.json`:

```json
{
  "scripts": {
    "dev": "parcel index.html"
  }
}
```

И запустить его:

```bash
npm run dev
```

В браузере будет виден HTML, и исполнится JS. Важно заметить, что в JS-файлах теперь можно безболезненно импортировать любые другие файлы — и локальные, и установленные через npm модули. Бандлер найдёт все нужные файлы и упакует в один большой файл, который отправится в браузер.

## На практике: Игорь Камышев

Обычно бандлеры, кроме сборки кода, умеют применять к нему трансформации. Например, можно писать приложение на современном JavaScript, а бандлер превратит его в понятный для старых браузеров код. Чаще всего для этой задачи используется [Babel](https://babeljs.io). При работе с Parcel Babel включён по умолчанию, и чтобы его настроить, достаточно создать в корне проекта файл `.browserslistrc` и перечислить в нем поддерживаемые браузеры:

```
last 1 version
> 1%
```

При такой конфигурации результирующий код будет корректно работать в последних версиях браузеров, в любых версиях, которые занимают больше 1 процента на рынке браузеров.

