Skip to main content
bun repl 启动一个交互式的读-求值-打印循环（REPL）来执行 JavaScript 和 TypeScript 表达式。它适用于快速测试代码片段、探索 API 和调试。
terminal
bun repl

Welcome to Bun v1.3.3
Type .copy [code] to copy to clipboard. .help for more info.

> 1 + 1
2
> const greeting = "Hello, Bun!"
undefined
> greeting
'Hello, Bun!'

​
功能

  • TypeScript 和 JSX — 直接书写 TypeScript 和 JSX。Bun 会即时转译所有代码。
  • 顶层 await — 直接在命令行等待 Promise，无需包裹在异步函数中。
  • 语法高亮 — 输入时即时高亮显示语法。
  • 持久化历史 — 历史记录保存到 ~/.bun_repl_history，跨会话保留。
  • Tab 自动补全 — 按 Tab 补全属性名和 REPL 命令。
  • 多行输入 — 未闭合的括号、大括号和圆括号会自动换行继续输入。
  • Node.js 全局变量 — 提供 require、module、__dirname 和 __filename，相对当前工作目录解析。

​
特殊变量

REPL 会暴露两个特殊变量，每次求值后会更新。
变量说明
_上一个表达式的结果
_error上一次抛出的错误
> 2 + 2
4
> _ * 10
40
> JSON.parse("oops")
SyntaxError: JSON Parse error: Unexpected identifier "oops"
> _error
SyntaxError: JSON Parse error: Unexpected identifier "oops"

​
顶层 await

Promise 会自动等待。你可以直接在命令行使用 await。 
> await fetch("https://api.github.com/repos/oven-sh/bun").then(r => r.json()).then(r => r.stargazers_count)
81234
> const response = await fetch("https://example.com")
undefined
> response.status
200

​
导入模块

与 Bun 运行时一样，你可以在 REPL 中使用 require 或 import，且能自由混合使用 ESM 和 CommonJS。模块解析规则与 bun run 相同，可以导入 node_modules、相对路径或 node: 内置模块。 
> import { z } from "zod"
undefined
> const path = require("path")
undefined
> z.string().parse(path.join("/tmp", "file.txt"))
'/tmp/file.txt'
声明会在整个会话中保持，且允许跨次执行重新声明 const / let（与普通脚本不同），方便你在迭代时重复执行 import 和 require 语句。

​
多行输入

当你在未闭合括号、大括号或圆括号的行按下 Enter，REPL 会自动换行继续。提示符变为 ... 表示续行。 
> function add(a, b) {
...   return a + b;
... }
undefined
> add(2, 3)
5
对于更长的多行输入，使用 .editor 进入编辑器模式，所有输入会缓冲直到按 Ctrl+D。

​
REPL 命令

在提示符输入 .help 查看所有可用的 REPL 命令。
命令说明
.help打印帮助信息，列出命令和快捷键
.exit退出 REPL
.clear清屏
.copy复制最近结果到剪贴板。也可以传入表达式计算并复制：.copy 1 + 1
.load加载文件到 REPL 会话：.load ./script.ts
.save将当前 REPL 历史保存到文件：.save ./session.txt
.editor进入多行编辑器模式（按 Ctrl+D 执行，Ctrl+C 取消）
.break取消当前多行输入
.history打印命令历史

​
快捷键

REPL 支持 Emacs 风格的行编辑。
快捷键功能
Ctrl+A移动光标至行首
Ctrl+E移动光标至行尾
Ctrl+B / Ctrl+F向后/向前移动一个字符
Alt+B / Alt+F向后/向前移动一个单词
Ctrl+U删除至行首
Ctrl+K删除至行尾
Ctrl+W向后删除一个单词
Ctrl+D删除字符（行为空时退出）
Ctrl+L清屏
Ctrl+T交换光标前两个字符
上箭头 / 下箭头浏览历史
Tab自动补全
Ctrl+C取消当前输入（空行时连续按两次退出）

​
历史记录

REPL 历史会自动保存到 ~/.bun_repl_history（最多 1000 条）并在每次会话开始时加载。使用上下键浏览。 若要导出历史到其它文件，使用 .save： 
> .save ./my-session.txt

​
非交互模式

使用 -e / --eval 以 REPL 语义执行脚本并退出。使用 -p / --print 除执行外会打印结果。
terminal
bun repl -e "const x: number = 42; console.log(x)"
# 42

bun repl -p "await fetch('https://example.com').then(r => r.status)"
# 200

bun repl -p "{ a: 1, b: 2 }"
# { a: 1, b: 2 }
该模式使用与交互 REPL 相同的转换，裸对象字面量如 { a: 1 } 会被当作对象表达式而非代码块。事件循环清空后进程退出（挂起的计时器和 I/O 会先执行完成）。出错时进程返回码为 1。