Skip to main content

​
概述

Bun 以单个无依赖的可执行文件形式发布。在 macOS、Linux 和 Windows 上可通过安装脚本、包管理器或 Docker 进行安装。
安装后，使用 bun --version 和 bun --revision 进行验证。

​
安装

Linux 用户 — 安装 Bun 需要 unzip 包（sudo apt install unzip）。建议使用内核版本 5.6 或更高版本；Bun 可运行在内核 3.10（RHEL 7）及以上版本，较新的系统调用会优雅降级。使用 uname -r 检查你的内核版本。
要检查 Bun 是否安装成功，打开一个新的终端窗口并运行：
terminal
如果你已安装 Bun 但遇到 command not found 错误，可能需要手动将安装目录（~/.bun/bin）添加到你的 PATH 中。
1

确定你使用的 shell

terminal
2

打开你的 shell 配置文件

  • 对于 bash：~/.bashrc
  • 对于 zsh：~/.zshrc
  • 对于 fish：~/.config/fish/config.fish
3

将 Bun 目录添加到 PATH

在配置文件中添加以下行：
terminal
4

重新加载 shell 配置

terminal

​
升级

安装后，Bun 二进制文件可以自行升级：
terminal
Homebrew 用户
为避免与 Homebrew 冲突，请改用 brew upgrade bun。Scoop 用户
为避免与 Scoop 冲突，请改用 scoop update bun。

​
Canary 构建

-> 查看 canary 构建 Bun 会在每次提交到主分支时自动发布一个（未经测试的）canary 构建。要升级到最新的 canary 构建：
terminal
使用 canary 构建可以在新功能和 Bug 修复发布稳定版之前进行测试。为了帮助 Bun 团队更快地修复 Bug，canary 构建会自动上传崩溃报告。

​
安装旧版本

由于 Bun 是单个二进制文件，你可以通过使用特定版本重新运行安装脚本来安装旧版本。
要安装特定版本，请将 git 标签传递给安装脚本：
terminal

​
直接下载

要直接下载 Bun 二进制文件，请访问 GitHub 上的 releases 页面。

​
最新版本下载

Linux x64

标准 Linux x64 二进制文件

Linux x64 Baseline

适用于不支持 AVX2 的老旧 CPU

Windows x64

标准 Windows 二进制文件

Windows x64 Baseline

适用于不支持 AVX2 的老旧 CPU

Windows ARM64

Windows on ARM（Snapdragon 等）

macOS ARM64

Apple Silicon（M1/M2/M3）

macOS x64

Intel Mac

Linux ARM64

ARM64 Linux 系统

​
Musl 二进制文件

适用于不含 glibc 的发行版（Alpine Linux、Void Linux）：
Bun 的 glibc 二进制文件需要 glibc 2.17 或更高版本。如果遇到类似 bun: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_... not found 的错误，请尝试使用 musl 二进制文件。Bun 的安装脚本会自动为你的系统选择正确的二进制文件。

​
CPU 要求

CPU 要求取决于你使用的二进制文件：
x64 二进制文件针对 Haswell CPU 架构（需要 AVX 和 AVX2 指令）
Bun 不支持比 baseline 目标更旧的 CPU，这需要 SSE4.2 扩展。Bun 需要 macOS 13.0 或更高版本。

​
卸载

要从系统中删除 Bun：
terminal