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