Uso da CLI bun build

bun build <pontos de entrada>

Configuração Geral

--productionboolean

Defina NODE_ENV=production e habilite a minificação

--bytecodeboolean

Use um cache de bytecode ao compilar

--targetstring default: browser

Ambiente de execução pretendido para o pacote. Um dos browser, bun ou node

--conditionsstring

Passe condições de resolução personalizadas

--envstring default: disable

Inline de variáveis de ambiente no pacote como process.env.${name}. Para inline de variáveis correspondendo a um prefixo, use um glob como FOO_PUBLIC_*

Saída e Manipulação de Arquivos

--outdirstring default: dist

Diretório de saída (usado ao compilar múltiplos pontos de entrada)

--outfilestring

Escreva a saída em um arquivo específico

--sourcemapstring default: none

Gere source maps. Um dos linked, inline, external ou none

--bannerstring

Adicione um cabeçalho à saída (ex. "use client" para React Server Components)

--footerstring

Adicione um rodapé à saída (ex. // built with bun!)

--formatstring default: esm

Formato do módulo do pacote de saída. Um dos esm, cjs ou iife

Nomenclatura de Arquivos

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

Personalize nomes de arquivos de pontos de entrada

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

Personalize nomes de arquivos de chunks

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

Personalize nomes de arquivos de assets

Opções de Bundling

--rootstring

Diretório raiz usado ao empacotar múltiplos pontos de entrada

--splittingboolean

Habilite code splitting para módulos compartilhados

--public-pathstring

Prefixo a ser adicionado aos caminhos de importação no código empacotado

--externalstring

Exclua módulos do pacote (suporta wildcards). Apelido: -e

--packagesstring default: bundle

Como tratar dependências: external ou bundle

--no-bundleboolean

Apenas transpile — não empacote

--css-chunkingboolean

Agrupe arquivos CSS para reduzir duplicação (apenas quando múltiplos pontos de entrada importam CSS)

Minificação e Otimização

--emit-dce-annotationsboolean default: true

Re-emitir anotações de Eliminação de Código Morto. Desativado quando --minify-whitespace é usado

--minifyboolean

Habilite todas as opções de minificação

--minify-syntaxboolean

Minifique sintaxe e inline de constantes

--minify-whitespaceboolean

Minifique whitespace

--minify-identifiersboolean

Minifique identificadores de variáveis e funções

--keep-namesboolean

Preserve nomes originais de funções e classes ao minificar

Recursos de Desenvolvimento

--watchboolean

Recrie automaticamente quando arquivos mudarem

--no-clear-screenboolean

Não limpe o terminal ao recriar com --watch

--react-fast-refreshboolean

Habilite a transformação React Fast Refresh (para testes de desenvolvimento)

Executáveis Standalone

--compileboolean

Gere um executável Bun standalone contendo o bundle. Implica --production

--compile-exec-argvstring

Prependa argumentos ao execArgv do executável standalone

Detalhes de Executáveis Windows

--windows-hide-consoleboolean

Previna que uma janela de console abra ao executar um executável Windows compilado

--windows-iconstring

Defina um ícone para o executável Windows

--windows-titlestring

Defina o nome do produto do executável Windows

--windows-publisherstring

Defina o nome da empresa do executável Windows

--windows-versionstring

Defina a versão do executável Windows (ex. 1.2.3.4)

--windows-descriptionstring

Defina a descrição do executável Windows

--windows-copyrightstring

Defina o aviso de copyright do executável Windows

Experimental e Construção de Apps

--appboolean

(EXPERIMENTAL) Construa um app web para produção usando Bun Bake

--server-componentsboolean

(EXPERIMENTAL) Habilite React Server Components

--debug-dump-server-filesboolean

Quando --app está definido, despeje todos os arquivos do servidor no disco mesmo para builds estáticos

--debug-no-minifyboolean

Quando --app está definido, desabilite toda minificação