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

​
升级

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

​
Canary 版本

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

​
安装旧版本

由于 Bun 是单一的二进制文件，你可以通过重新运行安装脚本并指定版本安装旧版本。
要安装指定版本，将 git 标签传入安装脚本：
terminal

​
直接下载

要直接下载 Bun 二进制文件，请访问 GitHub 发布页面。

​
最新版本下载

Linux x64

glibc、Nehalem 或更新版本

Linux ARM64

ARM64 Linux 系统

Windows x64

Nehalem 或更新版本

Windows ARM64

适用于 ARM 架构（如骁龙等）的 Windows

macOS ARM64

Apple Silicon (M1/M2/M3)

macOS x64

Intel Mac

​
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 要求

Bun 为每个平台提供一个 x64 二进制文件。它以 Nehalem 微架构（SSE4.2）为目标，并在 CPU 支持时于运行时选择 AVX2/AVX-512 代码路径，因此无需选择单独的“基准”下载版本。
Bun 不支持不具备 SSE4.2 扩展的 x64 CPU。Bun 需要 macOS 13.0 或更高版本。为兼容旧版安装脚本，-baseline 发布资源和 @oven/bun-*-x64-baseline npm 软件包会作为单一 x64 二进制文件的别名保留。

​
卸载

要从系统中移除 Bun：
terminal