Skip to main content
bun repl 会启动一个用于求值 JavaScript 和 TypeScript 表达式的交互式读取-求值-打印循环(REPL)。用它来测试代码片段、探索 API,并进行调试。
terminal

功能

  • TypeScript & JSX — 直接编写 TypeScript 和 JSX。Bun 会即时转译所有内容。
  • 顶层 await — 在提示符中直接等待 Promise,无需将其包装在异步函数中。
  • 语法高亮 — REPL 会在你输入时高亮显示内容。
  • 持久化历史记录 — REPL 会将历史记录保存到 ~/.bun_repl_history。历史记录会在不同会话之间保留。
  • Tab 自动补全 — 按 Tab 补全属性名和 REPL 命令。
  • 多行输入 — 未闭合的方括号、大括号和圆括号会自动在下一行继续。
  • Node.js 全局变量 — require、module、__dirname 和 __filename 均可用,并且会相对于当前工作目录解析。

特殊变量

REPL 会暴露两个特殊变量,每次求值后会更新。

顶层 await

你可以直接在提示符中对任意表达式使用 await。

导入模块

与 Bun 运行时一样,REPL 同时接受 require 和 import:你可以在提示符中自由混用 ES 模块和 CommonJS。模块解析使用与 bun run 相同的规则,因此你可以从 node_modules、相对路径或 node: 内置模块导入。
声明在整个会话期间都会保留。与常规脚本不同,你可以在多次求值之间重新声明 const/let,因此在迭代过程中可以重新运行 import 和 require 语句。

多行输入

当你在未闭合括号、大括号或圆括号的行按下 Enter,REPL 会自动换行继续。提示符变为 ... 表示续行。
对于更长的多行输入,使用 .editor 进入编辑器模式,所有输入会缓冲直到按 Ctrl+D。

REPL 命令

在提示符输入 .help 查看所有可用的 REPL 命令。

快捷键

REPL 支持 Emacs 风格的行编辑。

历史记录

REPL 会自动将历史记录保存到 ~/.bun_repl_history(最多 1000 条),并在每次会话开始时加载。使用 上箭头/下箭头 浏览历史记录。 若要导出历史到其它文件,使用 .save:

非交互模式

使用 -e / --eval 以 REPL 语义执行脚本并退出。使用 -p / --print 除执行外会打印结果。
terminal
这两个标志使用与交互式 REPL 相同的转换,因此 Bun 会将裸对象字面量(如 { a: 1 })视为对象表达式,而不是块语句。事件循环清空后进程会退出(待处理的定时器和 I/O 会先完成)。发生错误时,进程会以代码 1 退出。