【免费下载】 Bun项目安装与使用完全指南

Bun是一个现代化的JavaScript运行时环境，它集成了包管理器、测试运行器和打包工具等功能于一体。本文将详细介绍如何在各种操作系统上安装和使用Bun。

安装前的准备

Bun作为一个独立的可执行文件发布，无需额外依赖。但在安装前，建议了解以下信息：

1. Linux用户需要确保已安装unzip工具包（可通过sudo apt install unzip安装）
2. 建议使用Linux内核5.6或更高版本（最低要求5.1）
3. Windows用户需要Windows 10版本1809或更高

主流操作系统安装方法

macOS和Linux安装

macOS和Linux用户有以下几种安装方式可选：

使用curl一键安装（推荐）

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

如需安装特定版本：

curl -fsSL https://bun.sh/install | bash -s "bun-v$BUN_LATEST_VERSION"

通过npm安装

npm install -g bun

使用Homebrew安装

brew install oven-sh/bun/bun

Docker方式

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

Windows安装

Windows用户可选择以下安装方式：

PowerShell安装

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

通过npm安装

npm install -g bun

使用Scoop安装

scoop install bun

验证安装

安装完成后，可通过以下命令验证：

bun --version

如果显示版本号（如1.x.y），则表示安装成功。如果出现"command not found"错误，可能需要手动将Bun的安装目录（~/.bun/bin）添加到PATH环境变量中。

PATH环境变量配置

Linux/Mac配置

根据使用的shell类型，在对应的配置文件中添加以下内容：

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

保存后需要重新打开终端使配置生效。

Windows配置

可通过PowerShell执行以下命令：

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

配置完成后需要重启终端。

版本管理

升级Bun

Bun支持自我升级：

bun upgrade

注意：

• Homebrew用户应使用brew upgrade bun
• Scoop用户应使用scoop update bun

安装特定版本

Linux/Mac安装特定版本

curl -fsSL https://bun.sh/install | bash -s "bun-v$BUN_LATEST_VERSION"

Windows安装特定版本

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

使用Canary版本

Bun提供每日构建的Canary版本，适合尝鲜新功能：

bun upgrade --canary

如需回退到稳定版：

bun upgrade --stable

二进制文件直接下载

Bun提供多种架构的预编译二进制文件，包括：

• Linux x64/musl版本
• Windows x64版本
• macOS ARM64/x64版本
• Linux ARM64版本

musl版本适用于使用musl libc的Linux发行版（如Alpine Linux）。如果遇到GLIBC版本问题，建议尝试musl版本。

卸载Bun

如需卸载Bun，可根据安装方式选择对应的卸载方法：

curl安装方式卸载

rm -rf ~/.bun

Windows PowerShell卸载

powershell -c ~\.bun\uninstall.ps1

Scoop安装卸载

scoop uninstall bun

npm安装卸载

npm uninstall -g bun

Homebrew安装卸载

brew uninstall bun

结语

Bun作为一个新兴的JavaScript运行时，提供了简单高效的安装方式。无论您是开发新手还是资深工程师，都能快速上手使用。通过本文的详细指南，您应该已经掌握了Bun在各种环境下的安装、配置和管理方法。