Использование CLI bun build

bun build <точки входа>

Общая конфигурация

--productionboolean

Установить NODE_ENV=production и включить минификацию

--bytecodeboolean

Использовать кэш байт-кода при компиляции

--targetstring default: browser

Предполагаемая среда выполнения для бандла. Одно из browser, bun или node

--conditionsstring

Передать пользовательские условия разрешения

--envstring default: disable

Встроить переменные окружения в бандл как process.env.${name}. Для встраивания переменных, соответствующих префиксу, используйте глобальный шаблон, например FOO_PUBLIC_*

Вывод и обработка файлов

--outdirstring default: dist

Каталог вывода (используется при сборке нескольких точек входа)

--outfilestring

Записать вывод в указанный файл

--sourcemapstring default: none

Сгенерировать исходные карты. Одно из linked, inline, external или none

--bannerstring

Добавить заголовок к выводу (например, "use client" для React Server Components)

--footerstring

Добавить подвал к выводу (например, // built with bun!)

--formatstring default: esm

Формат модуля выходного бандла. Одно из esm, cjs или iife

Именование файлов

--entry-namingstring default: [dir]/[name].[ext]

Настроить имена файлов точек входа

--chunk-namingstring default: [name]-[hash].[ext]

Настроить имена файлов чанков

--asset-namingstring default: [name]-[hash].[ext]

Настроить имена файлов ресурсов

Опции бандлинга

--rootstring

Корневой каталог, используемый при бандлинге нескольких точек входа

--splittingboolean

Включить разделение кода для общих модулей

--public-pathstring

Префикс, добавляемый к путям импорта в бандл-коде

--externalstring

Исключить модули из бандла (поддерживаются подстановочные знаки). Псевдоним: -e

--packagesstring default: bundle

Как обрабатывать зависимости: external или bundle

--no-bundleboolean

Только транспиляция — не бандлить

--css-chunkingboolean

Объединять CSS файлы для уменьшения дублирования (только когда несколько точек входа импортируют CSS)

Минификация и оптимизация

--emit-dce-annotationsboolean default: true

Повторно эмитировать аннотации Dead Code Elimination. Отключено при использовании --minify-whitespace

--minifyboolean

Включить все опции минификации

--minify-syntaxboolean

Минифицировать синтаксис и встроенные константы

--minify-whitespaceboolean

Минифицировать пробелы

--minify-identifiersboolean

Минифицировать идентификаторы переменных и функций

--keep-namesboolean

Сохранять исходные имена функций и классов при минификации

Функции разработки

--watchboolean

Автоматически пересобирать при изменении файлов

--no-clear-screenboolean

Не очищать терминал при пересборке с --watch

--react-fast-refreshboolean

Включить трансформацию React Fast Refresh (для тестирования разработки)

Автономные исполняемые файлы

--compileboolean

Сгенерировать автономный исполняемый файл Bun, содержащий бандл. Подразумевает --production

--compile-exec-argvstring

Добавить аргументы в execArgv автономного исполняемого файла

Сведения об исполняемом файле Windows

--windows-hide-consoleboolean

Предотвратить открытие окна консоли при запуске скомпилированного исполняемого файла Windows

--windows-iconstring

Установить значок для исполняемого файла Windows

--windows-titlestring

Установить имя продукта исполняемого файла Windows

--windows-publisherstring

Установить имя компании исполняемого файла Windows

--windows-versionstring

Установить версию исполняемого файла Windows (например, 1.2.3.4)

--windows-descriptionstring

Установить описание исполняемого файла Windows

--windows-copyrightstring

Установить уведомление об авторских правах исполняемого файла Windows

Экспериментальные функции и создание приложений

--appboolean

(ЭКСПЕРИМЕНТАЛЬНО) Создать веб-приложение для продакшена с помощью Bun Bake

--server-componentsboolean

(ЭКСПЕРИМЕНТАЛЬНО) Включить React Server Components

--debug-dump-server-filesboolean

При установленном --app выводить все серверные файлы на диск даже для статических сборок

--debug-no-minifyboolean

При установленном --app отключить всю минификацию