> ## Documentation Index
> Fetch the complete documentation index at: https://bun.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# REPL

> 一个带语法高亮、历史记录和自动补全功能的交互式 JavaScript 和 TypeScript REPL

`bun repl` 会启动一个用于求值 JavaScript 和 TypeScript 表达式的交互式读取-求值-打印循环（REPL）。用它来测试代码片段、探索 API，并进行调试。

```sh terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
bun repl
```

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
欢迎使用 Bun v1.3.3
输入 .copy [code] 以复制到剪贴板。输入 .help 了解更多信息。

> 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` | 上一次抛出的错误  |

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
> 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`。

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
> 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:` 内置模块。

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
> 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 会自动换行继续。提示符变为 `...` 表示续行。

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
> 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`：

```txt theme={"theme":{"light":"github-light","dark":"dracula"}}
> .save ./my-session.txt
```

***

## 非交互模式

使用 `-e` / `--eval` 以 REPL 语义执行脚本并退出。使用 `-p` / `--print` 除执行外会打印结果。

```sh terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}}
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`。