概述

Bun 以单个无依赖的可执行文件形式发布。你可以在 macOS、Linux 和 Windows 上通过脚本、包管理器或 Docker 安装它。

警告

安装后，使用 bun --version 和 bun --revision 进行验证。

安装

macOS & Linux

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

警告

Linux 用户 - 安装 Bun 需要 unzip 包。使用 sudo apt install unzip 安装 unzip 包。强烈建议内核版本 5.6 或更高，但最低要求是 5.1。使用 uname -r 检查内核版本。

Windows

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

WARNING

Bun 需要 Windows 10 版本 1809 或更高版本。

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

包管理器

npm install -g bun # 你需要的最后一个 `npm` 命令

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun 提供支持 Linux x64 和 arm64 的 Docker 镜像。

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
# 输出：1.x.y

# 查看你使用的 `oven-sh/bun` 的精确提交
bun --revision
# 输出：1.x.y+b7982ac13189

WARNING

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

将 Bun 添加到 PATH

macOS & Linux

echo $SHELL
# /bin/zsh  或 /bin/bash 或 /bin/fish

打开你的 shell 配置文件

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

将 Bun 目录添加到 PATH

将此行添加到你的配置文件：

export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

重新加载你的 shell 配置

source ~/.bashrc  # 或 ~/.zshrc

Windows

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

如果命令成功运行但 bun --version 未被识别，这意味着 bun 不在你的系统 PATH 中。要修复此问题，打开 Powershell 终端并运行以下命令：

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

重启终端

运行命令后，重启终端并使用 bun --version 测试

bun --version

---

升级

安装后，二进制文件可以自我升级：

bun upgrade

---

Canary 构建

-> 查看 canary 构建

Bun 会在每次提交到 main 分支时自动发布（未经测试的）canary 构建。要升级到最新的 canary 构建：

# 升级到最新 canary
bun upgrade --canary

# 切换回稳定版
bun upgrade --stable

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

---

安装旧版本

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

Linux & macOS

要安装特定版本，将 git 标签传递给安装脚本：

curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"

Windows

在 Windows 上，将版本号传递给 PowerShell 安装脚本：

iex "& {$(irm https://bun.com/install.ps1)} -Version 1.3.3"

---

直接下载

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

最新版本下载

Linux x64

标准 Linux x64 二进制文件

Linux x64 Baseline

适用于没有 AVX2 的旧 CPU

Windows x64

标准 Windows 二进制文件

Windows x64 Baseline

适用于没有 AVX2 的旧 CPU

macOS ARM64

Apple Silicon (M1/M2/M3)

macOS x64

Intel Mac

Linux ARM64

ARM64 Linux 系统

Musl 二进制文件

对于没有 glibc 的发行版（Alpine Linux、Void Linux）：

• Linux x64 musl
• Linux x64 musl baseline
• Linux ARM64 musl

TIP

如果你遇到类似 bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found 的错误，请尝试使用 musl 二进制文件。Bun 的安装脚本会自动为你的系统选择正确的二进制文件。

---

CPU 要求

Bun 根据你使用的二进制文件有特定的 CPU 要求：

标准构建

x64 二进制文件 针对 Haswell CPU 架构（需要 AVX 和 AVX2 指令）

平台	Intel 要求	AMD 要求
x64	Haswell（第 4 代 Core）或更新	Excavator 或更新

Baseline 构建

x64-baseline 二进制文件 针对旧 CPU 的 Nehalem 架构

平台	Intel 要求	AMD 要求
x64-baseline	Nehalem（第 1 代 Core）或更新	Bulldozer 或更新

WARNING

Baseline 构建比普通构建慢。仅在遇到"Illegal Instruction"错误时使用它们。

::: note Bun 不支持旧于 baseline 目标的 CPU，这需要 SSE4.2 扩展。macOS 需要 13.0 或更高版本。 :::

卸载

要从系统中删除 Bun：

macOS & Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

包管理器

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun