Bun 速查表

快速开始

``bash # 运行脚本 bun run index.ts

# 监听模式——文件变更自动重启 bun run --watch index.ts

# 热替换模式——无需重启 bun --hot server.ts

# 启动开发模式（来自 package.json） bun dev

# 安装依赖 bun install

# 添加包 bun add zod

# 运行一次性 npm 包 bun x cowsay 'hello bun'

# 运行测试 bun test `

安装与设置

`bash bun --version # 查看版本 bun upgrade # 升级到最新 bun --help # 查看帮助 `

基础使用

`bash bun run index.ts # 运行文件 bun run --watch index.ts # 监听模式（自动重启） bun --hot server.ts # 热重载（无需重启） bun --smol index.ts # 低内存模式 bun . # 自动检测入口点 bun dev # 运行 dev 脚本 bun start # 运行 start 脚本 `

包管理

`bash bun install # 安装所有依赖 bun add zod # 添加依赖 bun add -d @types/bun # 添加开发依赖 bun add --exact zod@3.23.0 # 添加精确版本 bun remove zod # 移除依赖 bun update # 更新所有依赖 bun pm cache # 查看/清理缓存 bun pm ls # 列出已安装依赖 `

测试与调试

`bash bun test # 运行所有测试 bun test --watch # 监听模式 bun test --coverage # 生成覆盖率报告 bun test --bail # 首次失败即停止 bun test --timeout 10000 # 每个测试超时（毫秒） `

打包构建

`bash bun build ./src/index.ts --outdir ./dist # 打包为单文件 bun build --target bun ./src/index.ts --outdir ./dist # 指定 Bun 目标 bun build --minify ./src/index.ts --outdir ./dist # 压缩输出 bun build --splitting ./src/pages/*.tsx --outdir ./dist # 代码分割 bun build --sourcemap=external ./src/index.ts --outdir ./dist # 外部 SourceMap `

高级功能

`bash bun x cowsay 'hello' # 运行 npm 包（无需安装） bun create next-app # 从模板创建项目 bun init # 初始化新项目 bun link # 注册本地包到全局 bun patch lodash # 修补已安装的 npm 包 bun publish # 发布到 npm bun fig # 生成 Fig 自动补全规范 `

常见问题

### 如何配置 Bun？

在项目根目录创建 bunfig.toml（~/.bunfig.toml 也同样有效）。示例：

`toml [install] cache = true production = false frozenLockfile = false registry = "https://registry.npmjs.org/"

[test] preload = "./test/setup.ts" `

### bun.lock 是如何工作的？

Bun 使用二进制 lockfile 格式（bun.lock）而非 JSON。解析速度更快，磁盘占用更小。可以通过插件转换为 package-lock.json。建议提交到版本控制。要重新生成：删除 node_modules 和 bun.lock，然后运行 bun install。

### Bun 如何处理环境变量？

Bun 自动加载 .env 文件——无需 dotenv。它会读取 .env、.env.local、.env.production（根据 NODE_ENV 决定）。通过 process.env 访问：

`typescript const db = process.env.DATABASE_URL; `

### 能在现有 Node.js 项目中使用 Bun 吗？

可以！在任何 Node.js 项目中运行 bun install 即可替代 npm/yarn。大多数项目可以直接使用 bun run dev / bun run build`，因为 Bun 支持 package.json 脚本且兼容 Node.js API。部分项目可能需要针对边缘情况的 Node.js 内部 API 做少量调整。