Bun 執行環境旨在快速啟動與高效執行。

Bun 使用 JavaScriptCore 引擎，該引擎由 Apple 為 Safari 開發。JavaScriptCore 通常比 V8 啟動和執行得更快，V8 是 Node.js 和基於 Chromium 的瀏覽器所使用的引擎。Bun 的轉譯器和執行環境使用 Rust 編寫。在 Linux 上，Bun 的啟動速度比 Node.js 快 4 倍。

該基準測試在 Linux 上執行 Hello World 指令碼。

執行檔案

使用 bun run 執行原始檔。

bun run index.js

Bun 無需設定即可支援 TypeScript 和 JSX。Bun 會在執行每個檔案之前，使用原生的轉譯器即時轉譯檔案。

bun run index.js
bun run index.jsx
bun run index.ts
bun run index.tsx

或者，你可以省略 run 關鍵字，使用裸命令，行為完全相同。

bun index.tsx
bun index.js

--watch

使用 --watch 標誌可以以監聽模式執行檔案。

bun --watch run index.tsx

執行 package.json 指令碼

bun [bun 標誌] run <script> [指令碼標誌]

你的 package.json 可以定義與 Shell 命令對應的命名 "scripts"。

{
  // ... 其他欄位
  "scripts": {
    "clean": "rm -rf dist && echo 'Done.'",
    "dev": "bun server.ts"
  }
}

用 bun run <script> 執行這些指令碼。

bun run clean
rm -rf dist && echo 'Done.'

Done.

Bun 在子 Shell 中執行指令碼命令。在 Linux 和 macOS 上，它會按以下順序檢查 Shell，並使用找到的第一個：bash、sh、zsh。在 Windows 上，它使用 Bun Shell 來支援類似 bash 的語法和許多常用命令。

你也可以使用更短的命令 bun <script> 來執行指令碼。如果內建的 bun 命令與指令碼同名，則優先使用內建命令；此時請使用明確的 bun run <script> 來執行包指令碼。

bun run dev

要檢視可用指令碼列表，無需引數直接執行 bun run。

bun run

...
package.json scripts (2 found):
  $ bun run clean
    rm -rf dist && echo 'Done.'

  $ bun run dev
    bun server.ts

Bun 支援生命週期鉤子。例如，如果定義了 preclean 和 postclean，則 bun run clean 會依次執行它們。如果 pre<script> 執行失敗，Bun 不會執行指令碼本身。

--bun

通常 package.json 指令碼會引用本地安裝的 CLI，如 vite 或 next。這些 CLI 通常是帶有 shebang 的 JavaScript 檔案，用於指示使用 node 執行。

cli.js複製

#!/usr/bin/env node

// 執行相關操作

預設情況下，Bun 遵循此 shebang，並使用 node 執行指令碼。--bun 標誌會覆蓋此設定：CLI 將使用 Bun 而不是 Node.js 執行。

bun run --bun vite

過濾執行

在 monorepo 中，--filter 引數可以一次在多個包中執行指令碼。

bun run --filter <pattern> <script> 會在 <pattern> 選中的每個包中執行 <script>。模式可以是包名 glob、./path、{dir} 目錄或類似 foo... 的相依關係。 例如，如果你有幾個子目錄，其中包含名為 foo、bar 和 baz 的包，執行

bun run --filter 'ba*' <script>

會在 bar 和 baz 中執行 <script>，但不會在 foo 中執行。

請參閱 --filter。

bun run - 從 stdin 管道執行程式碼

bun run - 從 stdin 讀取 JavaScript、TypeScript、TSX 或 JSX，並在不先寫入臨時檔案的情況下執行。

echo "console.log('Hello')" | bun run -

Hello

你也可以用 bun run - 把檔案重定向給 Bun。例如，把 .js 檔案當作 .ts 檔案執行：

echo "console.log!('This is TypeScript!' as any)" > secretly-typescript.js
bun run - < secretly-typescript.js

This is TypeScript!

bun run - 會將所有輸入視為支援 JSX 的 TypeScript。

bun run --console-depth

用 --console-depth 標誌控制 console.log() 輸出中物件檢查的深度。

bun --console-depth 5 run index.tsx

--console-depth 設定 Bun 在 console.log() 輸出中顯示巢狀物件的深度。預設深度為 2。更大的值會顯示更多巢狀屬性，但對於複雜物件可能會產生冗長的輸出。

console.ts複製

const nested = { a: { b: { c: { d: "deep" } } } };
console.log(nested);
// 使用 --console-depth 2（預設值）：{ a: { b: { c: [Object] } } }
// 使用 --console-depth 4：{ a: { b: { c: { d: 'deep' } } } }

bun run --smol

在記憶體受限環境中，使用 --smol 標誌以降低記憶體使用，但會降低效能。

bun --smol run index.tsx

--smol 會使垃圾回收器更頻繁地執行，這可能會降低執行速度。無論是否使用 --smol 標誌，Bun 都會根據可用記憶體（考慮 cgroups 和其他記憶體限制）調整垃圾回收器的堆大小。因此，該標誌主要適用於希望堆增長得更慢的情況。

解析順序

Bun 始終將絕對路徑以及以 ./ 或 .\\ 開頭的路徑作為原始檔執行。除非使用 bun run，否則帶有允許的副檔名的名稱會解析為檔案，而不是 package.json 指令碼。

當 package.json 指令碼與檔案同名時，bun run 會優先選擇指令碼。完整的解析順序如下：

1. package.json 指令碼：bun run build
2. 原始檔：bun run src/main.js
3. 專案相依包中的二進位制檔案：bun add eslint && bun run eslint
4. （僅限 bun run）系統命令：bun run ls

CLI 用法

bun run <檔案或指令碼>

常規執行選項

工作空間管理

執行環境及行程控制

開發工作流

除錯

相依與模組解析

轉譯與語言特性

網路與安全

全域性設定與上下文

範例

執行一個 JavaScript 或 TypeScript 檔案：

bun run ./index.js
bun run ./index.tsx

執行 package.json 指令碼：

bun run dev
bun run lint