Bun 一体化 JS 工具包

它是什么

Bun 是 oven-sh 团队做的 JavaScript 和 TypeScript 应用一体化工具包。它是一个叫 bun 的单个可执行文件。核心是一个快速的运行时，README 称它是 Node.js 的直接替代品（drop-in replacement），基于 JavaScriptCore 构建。同一个命令还能运行测试和 package.json 里的脚本、安装软件包、打包代码。TypeScript 和 JSX 不用配置就能运行。

1. bun install 读取 package.json 并写出 bun.lock
2. bun run index.ts 直接运行 TypeScript 或 JSX
3. bun test 在 Bun 运行时里运行你的测试
4. bun build 为浏览器、Bun 或 Node 打包代码
5. bunx 把 npm 上的软件包装进 Bun 的缓存并运行它

适合谁

想用一个工具取代现在的运行时、包管理器、测试运行器和打包器的 JavaScript、TypeScript 开发者。README 说 Bun 的内置工具在现有 Node.js 项目里基本不用改动就能用，所以你可以一次只试一块。比如安装命令，不用 Bun 的运行时也能用。

如果你的项目依赖某个 Node.js 模块，而兼容性页面把它评为部分实现，请先看那一页。node:https 就是一个，页面列出了缺少的部分。

用在哪里

Bun 能在 Linux、macOS 和 Windows 上运行，文档介绍了几种部署位置。

• 你自己的电脑：Linux 和 Windows 上的 x64 或 arm64，macOS 上的 Intel 或 Apple Silicon，可以用安装脚本、npm、Homebrew 或 Scoop
• Docker：oven/bun 镜像，有 debian、slim、distroless 和 alpine 几个变体
• GitHub Actions：oven-sh/setup-bun 这个 action
• 托管：Vercel、Railway、Render、AWS Lambda、DigitalOcean 和 Google Cloud Run 的指南
• 编程智能体：bun init 检测到 Claude CLI 时会写一个 CLAUDE.md，检测到 Cursor 时会写一条 Cursor 规则。bun test 对 Claude Code、Replit 和任何设置了 AGENT=1 的智能体有安静模式

文档还有 Next.js、Astro、Remix 和 SvelteKit 这类框架的指南，以及 Express、Hono 和 Drizzle 这类库的指南。

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按 Bun 的文档列出了每个平台的步骤。主要途径是一行安装命令。

1. 运行适合你系统的安装命令。
2. 开一个新终端检查。运行 bun --version。
3. 找不到命令就改 PATH。把 ~/.bun/bin 文件夹加进 PATH，文档给出了 macOS、Linux 和 Windows 的写法。
4. 新建或安装项目。用 bun init 新建一个项目，或者在现有项目里运行 bun install。

curl -fsSL https://bun.com/install | bash

在 Windows 上，改在 PowerShell 里运行这一行。

powershell -c "irm bun.sh/install.ps1|iex"

用 npm、Homebrew 和 Scoop 也可以。上面第一行会把一个脚本直接交给 bash 运行。

npm install -g bun
brew install oven-sh/bun/bun
scoop install bun

如何使用

先输入 bun，再写你要运行的东西。Bun 自己的参数，比如 --watch，要紧跟在 bun 后面。

bun run index.tsx
bun --watch run index.tsx
bun test
bun build ./index.tsx --outdir ./build
bunx cowsay "Hello world!"

迁移指南列出了从 npm 换过来的写法。

示例

你按快速入门新建一个项目。你输入：

bun init my-app
cd my-app
bun run index.ts

Bun 让你选一个模板，你选 Blank。最后一条命令打印出 Hello via Bun!。然后你把 index.ts 换成一个小服务器。

const server = Bun.serve({
  port: 3000,
  routes: {
    "/": () => new Response('Bun!'),
  }
});

console.log(`Listening on ${server.url}`);

你再次运行 bun run index.ts。它打印出 Listening on http://localhost:3000/，这个地址上的页面写着 Bun!。快速入门接着往下，用 bun add figlet 加一个软件包，再加一个 HTML 文件，最后加一个 start 脚本。

新手与专家

新手：运行时就是在浏览器之外运行你的 JavaScript 的程序。Node.js 是另一个运行时。包管理器负责下载项目要用的库。打包器把很多文件合成几个浏览器能加载的文件。Bun 三样都做，还能用同一个命令跑测试。在一个空文件夹里运行 bun init，再照着快速入门做。Bun 运行 TypeScript 和 JSX 不需要配置。bun init 仍会写一个 tsconfig.json，供 bun check 和编辑器自动补全使用。

专家：除非你把某个软件包列在 trustedDependencies 里，否则 bun install 不会运行已安装依赖的生命周期脚本。对 esbuild 和 sharp 这类常用软件包，它还会自动优化 postinstall 脚本，判断哪些脚本需要运行。--frozen-lockfile 参数会严格按 bun.lock 安装，package.json 与它不一致时就报错退出。--production 参数隐含了它，bun install --frozen-lockfile --dry-run 只检查锁文件、不安装。

Bun 自己的参数要紧跟在 bun 后面。bun --watch run dev 有效，而 bun run dev --watch 会把这个参数交给你的脚本。监视模式会重启进程，--hot 则不重启进程、只重新加载代码。脚本以 node shebang 开头的软件包，默认在 node 上运行。加上 --bun 就改在 Bun 的运行时上运行。bun build 只有加上 --check 才检查类型。

注意事项

Bun 在你的电脑上运行。文档提到的网络使用有安装、更新和 canary 崩溃报告。

• 许可证：MIT。Bun 静态链接了 JavaScriptCore 和 WebKit，它们是 LGPL-2 许可，许可证页面还列出它链接的其他库及各自的许可证。发布用 Bun 构建的二进制文件之前，请先读那一页
• 安装脚本：Linux 和 macOS 的那一行会把下载的脚本直接交给 bash 运行，所以愿意的话可以先读一读它
• 更新：bun upgrade 更新 Bun。用 Homebrew 或 Scoop 的话，用 brew upgrade bun 或 scoop update bun。Canary 构建来自 main 分支的每一次提交，文档说它们没经过测试，还会自动上传崩溃报告
• 网络：bun install 和 bunx 从 npm 注册表读取，bunx 每天向它查询一次新版本。运行时在项目没有 node_modules 文件夹时也会自动安装软件包（--install 默认是 auto），用 --no-install 可以关掉。Mindket 读过的页面没有描述其他遥测
• 依赖脚本：在你信任某个软件包之前，它们一直关着，要在 package.json 里写明。文档说其他 npm 客户端默认会运行它们
• 兼容性：文档把在 Node.js 里能用、在 Bun 里不能用的软件包算作 Bun 的 bug。它们给每个 Node.js 模块和全局对象评为完全实现、部分实现或未实现（node:sea 未实现）
• 卸载：删掉你主目录里的 .bun 文件夹，Windows 上运行 powershell -c ~\.bun\uninstall.ps1，或者用你的包管理器的卸载