bun build CLI 用法

bun build <entry points>

常規配置

--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

生成 source map。可選值：linked、inline、external 或 none

--bannerstring

在輸出中添加 banner（例如 React Server Components 的 "use client"）

--footerstring

在輸出中添加 footer（例如 // built with bun!）

--formatstring default: esm

輸出打包的模塊格式。可選值：esm、cjs 或 iife

文件命名

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

自定義入口點文件名

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

自定義 chunk 文件名

--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

重新發出死代碼消除注釋。使用 --minify-whitespace 時禁用

--minifyboolean

啟用所有壓縮選項

--minify-syntaxboolean

壓縮語法和內聯常量

--minify-whitespaceboolean

壓縮空白字符

--minify-identifiersboolean

壓縮變量和函數標識符

--keep-namesboolean

壓縮時保留原始函數和類名

開發功能

--watchboolean

文件更改時自動重新構建

--no-clear-screenboolean

使用 --watch 重新構建時不清除終端屏幕

--react-fast-refreshboolean

啟用 React 快速刷新轉換（用於開發測試）

獨立可執行文件

--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 構建 Web 應用以進行生產

--server-componentsboolean

（實驗性） 啟用 React Server Components

--debug-dump-server-filesboolean

設置 --app 時，即使是靜態構建也將所有服務器文件轉儲到磁盤

--debug-no-minifyboolean

設置 --app 時，禁用所有壓縮