安装
通过 npm、Homebrew、Docker 或官方脚本安装 Bun。
概述
Bun 以单个、无依赖的可执行文件形式提供。在 macOS、Linux 和 Windows 上，可以使用安装脚本、包管理器或 Docker 进行安装。
安装
curl -fsSL https://bun.sh/install | bash
powershell -c "irm bun.sh/install.ps1|iex"
如需支持和交流，请加入 Discord 上的 #windows 频道。
npm install -g bun # 这是你最后一次需要运行的 npm 命令
Homebrewbrew install oven-sh/bun/bun
scoop install bun
Bun 提供支持 Linux x64 和 arm64 的 Docker 镜像。
docker pull oven/bun
docker run --rm --init --ulimit memlock=-1:-1 oven/bun
镜像变体
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
将 Bun 添加到你的 PATH
- 确认你使用的是哪个 shellterminal
echo $SHELL # 可能输出：/bin/zsh 或 /bin/bash 或 /bin/fish - 打开你的 shell 配置文件
- bash 使用：
~/.bashrc - zsh 使用：
~/.zshrc - fish 使用：
~/.config/fish/config.fish
- bash 使用：
- 将 Bun 目录添加到 PATH
将以下行添加到你的配置文件中：
terminalexport BUN_INSTALL="$HOME/.bun" export PATH="$BUN_INSTALL/bin:$PATH" - 重新加载你的 shell 配置terminal
source ~/.bashrc # 或者 ~/.zshrc
- 确认 bun 可执行文件是否正确安装terminal
& "$env:USERPROFILE\.bun\bin\bun" --version如果命令成功运行，但无法识别
bun --version，则说明 bun 不在系统的 PATH 中。要解决此问题，请打开 PowerShell 终端并运行以下命令：terminal[System.Environment]::SetEnvironmentVariable( "Path", [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin", [System.EnvironmentVariableTarget]::User ) - 重启你的终端
重启终端，然后使用
bun --version进行测试。terminalbun --version
升级
安装完成后，二进制文件可自动升级：
bun upgrade
Canary 版本
Bun 会在每次主分支提交时自动发布（未经测试的）Canary 版本。要升级到最新 Canary 版本：
# 升级到最新 Canary
bun upgrade --canary
# 切换回稳定版本
bun upgrade --stable
使用 Canary 构建版本，可以在新功能和错误修复进入稳定版本之前进行测试。为了帮助 Bun 团队更快地修复错误，Canary 构建版本会自动上传崩溃报告。
安装旧版本
由于 Bun 是单一的二进制文件，你可以通过重新运行安装脚本并指定版本安装旧版本。
要安装指定版本，将 git 标签传入安装脚本：
curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.3"
在 Windows 上，将版本号传入 PowerShell 安装脚本：
iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.3.3"
直接下载
要直接下载 Bun 二进制文件，请访问 GitHub 发布页面。
最新版本下载
glibc、Nehalem 或更新版本
ARM64 Linux 系统
Nehalem 或更新版本
适用于 ARM 架构（如骁龙等）的 Windows
Apple Silicon (M1/M2/M3)
Intel Mac
Musl 二进制
适用于不支持 glibc 的发行版（如 Alpine Linux、Void Linux）：
CPU 要求
Bun 为每个平台提供一个 x64 二进制文件。它以 Nehalem 微架构（SSE4.2）为目标，并在 CPU 支持时于运行时选择 AVX2/AVX-512 代码路径，因此无需选择单独的“基准”下载版本。
| 平台 | Intel 要求 | AMD 要求 |
|---|---|---|
| x64 | Nehalem（第 1 代 Core）或更新版本 | Bulldozer 或更新版本 |
卸载
要从系统中移除 Bun：
rm -rf ~/.bun
powershell -c ~\.bun\uninstall.ps1
npm uninstall -g bun
brew uninstall bun
scoop uninstall bun