Documentation Index Fetch the complete documentation index at: https://bun.zhcndoc.com/llms.txt
Use this file to discover all available pages before exploring further.
Bun 以单个无依赖的可执行文件形式发布。你可以通过脚本、包管理器或 Docker 在 macOS、Linux 和 Windows 上安装。
安装后，请使用 bun --version 和 bun --revision 进行验证。
macOS & Linux
Windows
包管理器
Docker
curl -fsSL https://bun.com/install | bash
Linux 用户 ：安装 Bun 需要 unzip 包。使用 sudo apt install unzip 安装 unzip 包。建议使用 5.6 或更高版本的内核；Bun 也可在更早的 3.10（RHEL 7）内核上运行，并会对较新的系统调用进行优雅降级。使用 uname -r 查看你的内核版本。
powershell - c " irm bun.sh/install.ps1|iex "
Bun 需要 Windows 10 版本 1809 或更高。
如需支持和讨论，请加入我们的 Discord 上的 #windows 频道。
Homebrew
npm install -g bun # 这是你最后一次需要运行的 npm 命令
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
如果你已安装 Bun，但出现 command not found 错误，可能需要手动将安装目录（~/.bun/bin）添加到你的 PATH 中。
确认你使用的是哪个 shell
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
确认 bun 可执行文件是否正确安装
& " $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 安装完成后，二进制文件可自动升级：
Homebrew 用户 brew upgrade bun。Scoop 用户 scoop update bun。
Canary 版本 -> 查看 Canary 版本 Bun 会在每次主分支提交时自动发布（未经测试的）Canary 版本。要升级到最新 Canary 版本：
# 升级到最新 Canary bun upgrade --canary # 切换回稳定版本 bun upgrade --stable
Canary 版本适用于测试新功能和修复 bug，帮助 Bun 团队更快修复问题。Canary 版本会自动上传崩溃报告给 Bun 团队。
安装旧版本 由于 Bun 是单一的二进制文件，你可以通过重新运行安装脚本并指定版本安装旧版本。
要安装指定版本，传入 git 标签给安装脚本： curl -fsSL https://bun.com/install | bash -s " bun-v1.3.3 "
在 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
Windows ARM64 适用于 ARM 架构（如骁龙等）的 Windows
macOS ARM64 Apple Silicon (M1/M2/M3)
Linux ARM64 ARM64 Linux 系统
Musl 二进制 适用于不支持 glibc 的发行版（如 Alpine Linux, Void Linux）：
Bun 的 glibc 二进制需要 glibc 2.17 或更高版本。如果你遇到类似 bun: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_... not found 的错误，请尝试使用 musl 二进制。Bun 的安装脚本会自动为你的系统选择正确的二进制。
CPU 要求 Bun 根据你使用的二进制文件对 CPU 有不同的要求：
x64 二进制 目标为 Haswell CPU 架构（需要 AVX 和 AVX2 指令集）平台 Intel 要求 AMD 要求 x64 Haswell（第四代 Core）及更新 Excavator 及更新
x64-baseline 二进制 目标为 Nehalem 架构，用于较老的 CPU平台 Intel 要求 AMD 要求 x64-baseline Nehalem（第一代 Core）及更新 Bulldozer 及更新
Baseline 版本运行速度较慢，仅在遇到 “Illegal Instruction” 错误时使用。
Bun 不支持低于 baseline 目标的 CPU，该目标要求支持 SSE4.2 指令集。macOS 也要求版本为 13.0 或更高。
要从系统中移除 Bun：
macOS & Linux
Windows
包管理器
powershell - c ~\.bun\uninstall.ps1
Homebrew
