Bun JS 安装

概述

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

警告

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

安装

macOS & Linux

bash

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

警告

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

Windows

powershell

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

WARNING

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

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

包管理器

bash

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

bash

brew install oven-sh/bun/bun

bash

scoop install bun

Docker

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

bash

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

镜像变体

还有针对不同操作系统的镜像变体：

bash

docker pull oven/bun:debian
docker pull oven/bun:slim
docker pull oven/bun:distroless
docker pull oven/bun:alpine

要检查 Bun 是否安装成功，打开新的终端窗口并运行：

bash

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

bash

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

打开你的 shell 配置文件

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

将 Bun 目录添加到 PATH

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

bash

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

重新加载你的 shell 配置

bash

source ~/.bashrc  # 或 ~/.zshrc

Windows

bash

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

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

bash

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

重启终端

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

bash

bun --version

升级

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

bash

bun upgrade

Canary 构建

-> 查看 canary 构建

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

bash

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

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

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

安装旧版本

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

Linux & macOS

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

bash

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

Windows

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

powershell

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

直接下载

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

Musl 二进制文件

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

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

bash

rm -rf ~/.bun

Windows

powershell

powershell -c ~\.bun\uninstall.ps1

包管理器

bash

npm uninstall -g bun

bash

brew uninstall bun

bash

scoop uninstall bun

概述 ​

安装 ​

macOS & Linux ​

Windows ​

包管理器 ​

Docker ​

镜像变体 ​

将 Bun 添加到 PATH ​

macOS & Linux ​

打开你的 shell 配置文件 ​

将 Bun 目录添加到 PATH ​

重新加载你的 shell 配置 ​

Windows ​

重启终端 ​

升级 ​

Canary 构建 ​

安装旧版本 ​

Linux & macOS ​

Windows ​

直接下载 ​

最新版本下载 ​

Musl 二进制文件 ​

CPU 要求 ​

标准构建 ​

Baseline 构建 ​

卸载 ​

macOS & Linux ​

Windows ​

包管理器 ​

概述

安装

macOS & Linux

Windows

包管理器

Docker

镜像变体

将 Bun 添加到 PATH

macOS & Linux

打开你的 shell 配置文件

将 Bun 目录添加到 PATH

重新加载你的 shell 配置

Windows

重启终端

升级

Canary 构建

安装旧版本

Linux & macOS

Windows

直接下载

最新版本下载

Musl 二进制文件

CPU 要求

标准构建

Baseline 构建

卸载

macOS & Linux

Windows

包管理器