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

标准 Linux x64 二进制

Linux x64 Baseline

适用于不支持 AVX2 的旧 CPU

Windows x64

标准 Windows 二进制

Windows x64 Baseline

适用于不支持 AVX2 的旧 CPU

Windows ARM64

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

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 不支持早于基线目标的 CPU，该目标要求支持 SSE4.2 扩展。Bun 要求 macOS 13.0 或更高版本。

​
卸载

要从系统中移除 Bun：
terminal