Utilisation CLI de bun build

bun build <entry points>

Configuration générale

--productionboolean

Définit NODE_ENV=production et active la minification

--bytecodeboolean

Utilise un cache de bytecode lors de la compilation

--targetstring default: browser

Environnement d'exécution prévu pour le bundle. L'une des valeurs browser, bun, ou node

--conditionsstring

Passe des conditions de résolution personnalisées

--envstring default: disable

Inline les variables d'environnement dans le bundle en tant que process.env.${name}. Pour inline les variables correspondant à un préfixe, utilisez un glob comme FOO_PUBLIC_*

Sortie et gestion des fichiers

--outdirstring default: dist

Répertoire de sortie (utilisé lors de la construction de plusieurs points d'entrée)

--outfilestring

Écrit la sortie dans un fichier spécifique

--sourcemapstring default: none

Génère des source maps. L'une des valeurs linked, inline, external, ou none

--bannerstring

Ajoute un en-tête à la sortie (par ex. "use client" pour React Server Components)

--footerstring

Ajoute un pied de page à la sortie (par ex. // built with bun!)

--formatstring default: esm

Format de module du bundle de sortie. L'une des valeurs esm, cjs, ou iife

Nommage des fichiers

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

Personnalise les noms de fichiers des points d'entrée

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

Personnalise les noms de fichiers des chunks

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

Personnalise les noms de fichiers des assets

Options de bundling

--rootstring

Répertoire racine utilisé lors du bundling de plusieurs points d'entrée

--splittingboolean

Active le code splitting pour les modules partagés

--public-pathstring

Préfixe à ajouter aux chemins d'import dans le code bundle

--externalstring

Exclut les modules du bundle (prend en charge les wildcards). Alias : -e

--packagesstring default: bundle

Comment traiter les dépendances : external ou bundle

--no-bundleboolean

Transpile uniquement — ne bundle pas

--css-chunkingboolean

Regroupe les fichiers CSS pour réduire la duplication (uniquement lorsque plusieurs points d'entrée importent du CSS)

Minification et optimisation

--emit-dce-annotationsboolean default: true

Réémet les annotations Dead Code Elimination. Désactivé lorsque --minify-whitespace est utilisé

--minifyboolean

Active toutes les options de minification

--minify-syntaxboolean

Minifie la syntaxe et inline les constantes

--minify-whitespaceboolean

Minifie les espaces

--minify-identifiersboolean

Minifie les variables et les identifiants de fonction

--keep-namesboolean

Préserve les noms de fonction et de classe originaux lors de la minification

Fonctionnalités de développement

--watchboolean

Reconstruit automatiquement lorsque les fichiers changent

--no-clear-screenboolean

Ne pas effacer le terminal lors de la reconstruction avec --watch

--react-fast-refreshboolean

Active la transformation React Fast Refresh (pour les tests de développement)

Exécutables autonomes

--compileboolean

Génère un exécutable Bun autonome contenant le bundle. Implique --production

--compile-exec-argvstring

Ajoute des arguments en préfixe à l'execArgv de l'exécutable autonome

Détails des exécutables Windows

--windows-hide-consoleboolean

Empêche l'ouverture d'une fenêtre de console lors de l'exécution d'un exécutable Windows compilé

--windows-iconstring

Définit une icône pour l'exécutable Windows

--windows-titlestring

Définit le nom du produit de l'exécutable Windows

--windows-publisherstring

Définit le nom de la société de l'exécutable Windows

--windows-versionstring

Définit la version de l'exécutable Windows (par ex. 1.2.3.4)

--windows-descriptionstring

Définit la description de l'exécutable Windows

--windows-copyrightstring

Définit la notice de copyright de l'exécutable Windows

Expérimental et construction d'applications

--appboolean

(EXPÉRIMENTAL) Construit une application web pour la production en utilisant Bun Bake

--server-componentsboolean

(EXPÉRIMENTAL) Active React Server Components

--debug-dump-server-filesboolean

Lorsque --app est défini, dump tous les fichiers serveur sur le disque même pour les builds statiques

--debug-no-minifyboolean

Lorsque --app est défini, désactive toute minification