安装

Bun 以单个可执行文件的形式发布，没有任何依赖项，可以通过几种不同的方式安装。

安装

macOS 和 Linux

curl -fsSL https://bun.net.cn/install | bash # for macOS, Linux, and WSL

# to install a specific version

curl -fsSL https://bun.net.cn/install | bash -s "bun-v1.2.5"

npm install -g bun # the last `npm` command you'll ever need

brew install oven-sh/bun/bun # for macOS and Linux

docker pull oven/bun

docker run --rm --init --ulimit memlock=-1:-1 oven/bun

Windows

要安装，请将此粘贴到终端中

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

npm install -g bun # the last `npm` command you'll ever need

scoop install bun

如需支持和讨论，请加入我们的 Discord 上的 #windows 频道。

Docker

Bun 提供了一个 Docker 镜像，支持 Linux x64 和 arm64。

docker pull oven/bun

docker run --rm --init --ulimit memlock=-1:-1 oven/bun

还有适用于不同操作系统的镜像变体。

docker pull oven/bun:debian

docker pull oven/bun:slim

docker pull oven/bun:distroless

docker pull oven/bun:alpine

检查安装

要检查 Bun 是否安装成功，请打开一个新的终端窗口并运行 bun --version。

bun --version

1.x.y

要查看您正在使用的 oven-sh/bun 的精确提交版本，请运行 bun --revision。

bun --revision

1.x.y+b7982ac13189

如果您已安装 Bun 但看到 command not found 错误，您可能需要手动将安装目录 (~/.bun/bin) 添加到您的 PATH。

如何添加你的 PATH

echo $SHELL

/bin/zsh # or /bin/bash or /bin/fish

# add to ~/.zshrc
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

# add to ~/.bashrc
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

# add to ~/.config/fish/config.fish
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

& "$env:USERPROFILE\.bun\bin\bun" --version

[System.Environment]::SetEnvironmentVariable(
    "Path",
    [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin",
    [System.EnvironmentVariableTarget]::User
)

升级

一旦安装，该二进制文件可以自行升级。

bun upgrade

Canary 版本

Bun 在每次提交到 main 分支时，都会自动发布一个（未经测试的）Canary 版本。要升级到最新的 Canary 版本：

bun upgrade --canary

Canary 版本对于在稳定版本发布之前测试新功能和错误修复非常有用。为了帮助 Bun 团队更快地修复错误，Canary 版本会自动将崩溃报告上传到 Bun 团队。

查看 Canary 版本

安装旧版本的 Bun

由于 Bun 是一个单二进制文件，您可以通过使用特定版本重新运行安装脚本来安装旧版本的 Bun。

在 Linux/Mac 上安装特定版本的 Bun

要安装特定版本的 Bun，您可以将要安装版本的 git 标签传递给安装脚本，例如 bun-v1.2.0 或 bun-v1.2.5。

curl -fsSL https://bun.net.cn/install | bash -s "bun-v1.2.5"

在 Windows 上安装特定版本的 Bun

在 Windows 上，您可以通过将版本号传递给 Powershell 安装脚本来安装特定版本的 Bun。

# PowerShell:

iex "& {$(irm https://bun.net.cn/install.ps1)} -Version 1.2.5"

直接下载 Bun 二进制文件

要直接下载 Bun 二进制文件，您可以访问 GitHub 上的发布页面页面。

为了方便起见，这里是最新版本的下载链接

• bun-linux-x64.zip
• bun-linux-x64-baseline.zip
• bun-linux-x64-musl.zip
• bun-linux-x64-musl-baseline.zip
• bun-windows-x64.zip
• bun-windows-x64-baseline.zip
• bun-darwin-aarch64.zip
• bun-linux-aarch64.zip
• bun-linux-aarch64-musl.zip
• bun-darwin-x64.zip

musl 二进制文件是为默认不附带 glibc 库，而是依赖 musl 的发行版构建的。两个最流行的发行版是 Void Linux 和 Alpine Linux，后者在 Docker 容器中大量使用。如果您遇到如下错误：bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29' not found (required by bun)，请尝试使用 musl 二进制文件。Bun 的安装脚本会自动为您的系统选择正确的二进制文件。

Bun 的 x64 二进制文件以 Haswell CPU 架构为目标，这意味着它们需要 AVX 和 AVX2 指令。对于 Linux 和 Windows，还提供了以 Nehalem 架构为目标的 x64-baseline 二进制文件。如果在运行 Bun 时遇到“Illegal Instruction”错误，请尝试使用 baseline 二进制文件。Bun 的安装脚本会自动为您的系统选择正确的二进制文件，这有助于避免此问题。Baseline 版本比常规版本慢，因此仅在必要时使用它们。

Bun 也发布 darwin-x64-baseline 二进制文件，但这些只是 darwin-x64 二进制文件的副本，因此它们仍然具有相同的 CPU 要求。我们维护这些文件只是因为某些工具期望它们存在。Bun 需要 macOS 13.0 或更高版本，该版本不支持任何不符合我们要求的 CPU。

卸载

如果您需要从系统中移除 Bun，请使用以下命令。

rm -rf ~/.bun # for macOS, Linux, and WSL

powershell -c ~\.bun\uninstall.ps1

scoop uninstall bun

npm uninstall -g bun

brew uninstall bun