Skip to main content

​
概述

Bun 以单个无依赖的可执行文件形式发布。你可以通过脚本、包管理器或 Docker 在 macOS、Linux 和 Windows 上安装。
安装后，请使用 bun --version 和 bun --revision 进行验证。

​
安装

curl -fsSL https://bun.com/install | bash
Linux 用户  安装 Bun 需要 unzip 包。使用 sudo apt install unzip 安装该包。强烈建议内核版本为 5.6 或更高，最低要求为 5.1。使用 uname -r 查看内核版本。
要确认 Bun 是否成功安装，请打开一个新终端窗口并运行：
terminal
bun --version
# 输出示例：1.x.y

# 查看你正在使用的 `oven-sh/bun` 的精确提交版本
bun --revision
# 输出示例：1.x.y+b7982ac13189
如果你已安装 Bun，但出现 command not found 错误，可能需要手动将安装目录（~/.bun/bin）添加到你的 PATH 中。
1

确认你使用的是哪个 shell

terminal
echo $SHELL
# 可能输出：/bin/zsh 或 /bin/bash 或 /bin/fish
2

打开你的 shell 配置文件

  • bash 使用：~/.bashrc
  • zsh 使用：~/.zshrc
  • fish 使用：~/.config/fish/config.fish
3

将 Bun 目录添加到 PATH

在配置文件中添加以下内容：
terminal
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"
4

重新加载你的 shell 配置

terminal
source ~/.bashrc  # 或者 ~/.zshrc

​
升级

安装完成后，二进制文件可自动升级：
terminal
bun upgrade
Homebrew 用户
为避免与 Homebrew 冲突，请改用命令 brew upgrade bun。Scoop 用户
为避免与 Scoop 冲突，请改用命令 scoop update bun。

​
Canary 版本

-> 查看 Canary 版本 Bun 会在每次主分支提交时自动发布（未经测试的）Canary 版本。要升级到最新 Canary 版本：
terminal
# 升级到最新 Canary
bun upgrade --canary

# 切换回稳定版本
bun upgrade --stable
Canary 版本适用于测试新功能和修复 bug，帮助 Bun 团队更快修复问题。Canary 版本会自动上传崩溃报告给 Bun 团队。

​
安装旧版本

由于 Bun 是单一的二进制文件，你可以通过重新运行安装脚本并指定版本安装旧版本。
要安装指定版本，传入 git 标签给安装脚本：
terminal
curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"

​
直接下载

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

​
最新版本下载

https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/linux.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=caad6caa40a1bb51528e3d505ef2543f

Linux x64

标准 Linux x64 二进制
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/linux.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=caad6caa40a1bb51528e3d505ef2543f

Linux x64 Baseline

适用于不支持 AVX2 的旧 CPU
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/windows.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=c63f676fea5e27df2d6759902dafc308

Windows x64

标准 Windows 二进制
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/windows.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=c63f676fea5e27df2d6759902dafc308

Windows x64 Baseline

适用于不支持 AVX2 的旧 CPU
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/apple.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=34efc754e8f303939d9f0c7b88f45268

macOS ARM64

Apple Silicon (M1/M2/M3)
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/apple.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=34efc754e8f303939d9f0c7b88f45268

macOS x64

Intel Mac
https://mintcdn.com/ikxin/RzFFGbzo0-4huILA/icons/linux.svg?fit=max&auto=format&n=RzFFGbzo0-4huILA&q=85&s=caad6caa40a1bb51528e3d505ef2543f

Linux ARM64

ARM64 Linux 系统

​
Musl 二进制

适用于不支持 glibc 的发行版（如 Alpine Linux, Void Linux）：
如果你遇到类似 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 要求
x64Haswell（第四代 Core）及更新Excavator 及更新
Bun 不支持低于 baseline 目标的 CPU，该目标要求支持 SSE4.2 指令集。macOS 也要求版本为 13.0 或更高。

​
卸载

要从系统中移除 Bun：
terminal
rm -rf ~/.bun