bun build CLI-Verwendung

bun build <entry points>

Allgemeine Konfiguration

--productionboolean

Setzt NODE_ENV=production und aktiviert die Minifizierung

--bytecodeboolean

Verwendet einen Bytecode-Cache beim Kompilieren

--targetstring default: browser

Beabsichtigte Ausführungsumgebung für das Bündel. Einer von browser, bun oder node

--conditionsstring

Übergibt benutzerdefinierte Auflösungsbedingungen

--envstring default: disable

Bindet Umgebungsvariablen als process.env.${name} in das Bündel ein. Um Variablen mit einem Präfix einzubinden, verwenden Sie einen Glob wie FOO_PUBLIC_*

Ausgabe und Dateiverwaltung

--outdirstring default: dist

Ausgabeverzeichnis (wird beim Erstellen mehrerer Einstiegspunkte verwendet)

--outfilestring

Ausgabe in eine bestimmte Datei schreiben

--sourcemapstring default: none

Quellkarten generieren. Einer von linked, inline, external oder none

--bannerstring

Fügt einen Banner zur Ausgabe hinzu (z.B. "use client" für React Server Components)

--footerstring

Fügt einen Footer zur Ausgabe hinzu (z.B. // built with bun!)

--formatstring default: esm

Modulformat des Ausgabebündels. Einer von esm, cjs oder iife

Dateibenennung

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

Einstiegspunkt-Dateinamen anpassen

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

Chunk-Dateinamen anpassen

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

Asset-Dateinamen anpassen

Bündelungsoptionen

--rootstring

Stammverzeichnis beim Bündeln mehrerer Einstiegspunkte

--splittingboolean

Aktiviert Code-Splitting für gemeinsame Module

--public-pathstring

Präfix, das zu Importpfaden im gebündelten Code hinzugefügt wird

--externalstring

Schließt Module vom Bündel aus (unterstützt Wildcards). Alias: -e

--packagesstring default: bundle

Wie mit Abhängigkeiten umgehen: external oder bundle

--no-bundleboolean

Nur transpilieren – nicht bündeln

--css-chunkingboolean

CSS-Dateien zusammenfassen, um Duplizierung zu reduzieren (nur wenn mehrere Einstiegspunkte CSS importieren)

Minifizierung und Optimierung

--emit-dce-annotationsboolean default: true

Annotations für Dead Code Elimination erneut ausgeben. Deaktiviert, wenn --minify-whitespace verwendet wird

--minifyboolean

Aktiviert alle Minifizierungsoptionen

--minify-syntaxboolean

Syntax und Inline-Konstanten minifizieren

--minify-whitespaceboolean

Leerzeichen minifizieren

--minify-identifiersboolean

Variablen- und Funktionsbezeichner minifizieren

--keep-namesboolean

Ursprüngliche Funktions- und Klassennamen beim Minifizieren beibehalten

Entwicklungsfunktionen

--watchboolean

Bei Dateiänderungen automatisch neu erstellen

--no-clear-screenboolean

Terminal beim Neuerstellen mit --watch nicht leeren

--react-fast-refreshboolean

React Fast Refresh-Transformation aktivieren (für Entwicklungstests)

Eigenständige Executables

--compileboolean

Generiert eine eigenständige Bun-Executable, die das Bündel enthält. Impliziert --production

--compile-exec-argvstring

Fügt Argumente am Anfang des execArgv der eigenständigen Executable hinzu

Windows-Executable-Details

--windows-hide-consoleboolean

Verhindert das Öffnen eines Konsolenfensters beim Ausführen einer kompilierten Windows-Executable

--windows-iconstring

Legt ein Symbol für die Windows-Executable fest

--windows-titlestring

Legt den Produktnamen der Windows-Executable fest

--windows-publisherstring

Legt den Firmennamen der Windows-Executable fest

--windows-versionstring

Legt die Version der Windows-Executable fest (z.B. 1.2.3.4)

--windows-descriptionstring

Legt die Beschreibung der Windows-Executable fest

--windows-copyrightstring

Legt den Copyright-Hinweis der Windows-Executable fest

Experimentell und App-Erstellung

--appboolean

(EXPERIMENTELL) Erstellt eine Web-App für die Produktion mit Bun Bake

--server-componentsboolean

(EXPERIMENTELL) Aktiviert React Server Components

--debug-dump-server-filesboolean

Wenn --app gesetzt ist, alle Server-Dateien auf die Festplatte schreiben, auch für statische Builds

--debug-no-minifyboolean

Wenn --app gesetzt ist, alle Minifizierungen deaktivieren