Bun项目安装与使用完全指南
项目地址: https://gitcode.com/GitHub_Trending/bu/bun Bun是一个现代化的JavaScript运行时环境，它集成了包管理器、测试运行器和打包工具等功能于一体。本文将详细介绍如何在各种操作系统上安装和使用Bun。
安装前的准备
Bun作为一个独立的可执行文件发布，无需额外依赖。但在安装前，建议了解以下信息：
- Linux用户需要确保已安装
unzip工具包（可通过sudo apt install unzip安装） - 建议使用Linux内核5.6或更高版本（最低要求5.1）
- 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在各种环境下的安装、配置和管理方法。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
