跳到主要内容

安装

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

安装​

macOS 和 Linux​

备注

对于 Linux 用户 — 安装 Bun 时需要使用 unzip 软件包。请使用 sudo apt install unzip 命令安装 unzip 软件包。 强烈建议使用 5.6 或更高版本的内核，支持的最低版本为 5.1。请使用 uname -r 检查内核版本号。

$ curl -fsSL https://bun.sh/install | bash # 针对 macOS、Linux 和 WSL
# 如需安装特定版本
$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.0.0"

Windows​

将以下命令粘贴到命令行中并执行：

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

Bun 最低支持 Windows 10 version 1809

如需获取支持并加入讨论组，请加入 Discord 上的 #windows 频道 。

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:alpine
$ docker pull oven/bun:distroless

检查安装情况​

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

$ bun --version
1.x.y

要查看正在使用的 oven-sh/bun 的确切的 commit 序号，请运行 bun --revision 命令。

$ bun --revision
1.x.y+b7982ac13189

如果你已经安装了 Bun，但还是报 command not found 错误，可能需要你手动将安装目录（~/.bun/bin）添加到 PATH 环境变量中。

How to add to your PATH

首先，确定你所使用的 shell：

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

然后在 shell 配置文件底部添加以下几行配置。

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

保存文件。然后打开一个新的 shell/终端窗口，以使更改生效。

升级​

安装完成后，Bun 的二进制文件可以自行升级。

$ bun upgrade
备注

对于 Homebrew 用户 — 为避免与 Homebrew 冲突，请使用 brew upgrade bun 命令代替。

对于 Scoop 用户 — 为避免与 Scoop 冲突，请使用 scoop update bun 命令代替。

Canary 构建版本​

每次提交代码到 main 分支时，Bun 都会自动发布一个（未经测试的）canary 构建版本。要升级到最新的 canary 构建版本，请执行：

$ bun upgrade --canary

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

查看 canary 构建版本

备注

注意 — 要从 canary 构建版本切换回稳定版本的话，请执行 bun upgrade --stable 命令。

安装旧版本的 Bun​

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

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

要安装特定版本的 Bun，你可以将想要安装的版本的 git tag 传递给安装脚本，例如 bun-v1.1.6 或 bun-v1.1.1。

$ curl -fsSL https://bun.sh/install | bash -s "bun-v1.1.6"

在 Windows 上安装特定版本的 Bun​

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

# PowerShell:
$ iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.1.6"

直接下载 Bun 的二进制文件​

要直接下载 Bun 的二进制文件，请访问 GitHub 上的 版本列表页面 。

为方便起见，下面列出的是最新版本的下载链接：

带有 baseline 标记的二进制文件是为不支持 AVX2 指令的老 CPU 而构建的。如果运行 Bun 时遇到提示“非法指令（Illegal Instruction）”的错误，请尝试使用 baseline 二进制文件。Bun 的安装脚本会自动为你的系统选择正确的二进制文件，这有助于避免这一问题。baseline 版本的编译比常规编译慢，因此只有在必要时才使用。

卸载​

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

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