5个步骤掌握Bun：从安装到精通

Bun是一个集JavaScript运行时环境、打包工具、测试运行器和包管理器于一体的开源项目，以其卓越的性能和简洁的使用体验受到开发者青睐。本文将通过五个清晰步骤，帮助你从零开始掌握Bun的安装配置与基础使用，即使是零基础也能轻松上手。

一、环境准备：系统兼容性与前置要求

在开始安装Bun之前，需要确保你的系统满足基本要求。Bun作为独立可执行文件发布，对系统环境有特定要求：

支持的操作系统版本

操作系统	最低版本要求	推荐配置
Linux	内核5.1+	内核5.6+，已安装unzip
macOS	10.15+	11.0+，Xcode命令行工具
Windows	10 1809+	11，WSL2支持

必要准备工作

第一步：检查系统版本

• Linux用户：打开终端执行uname -r查看内核版本，确保≥5.1
• Windows用户：按Win+R输入winver检查系统版本
• macOS用户：点击苹果菜单→关于本机，确认系统版本≥10.15

第二步：安装依赖工具

• Debian/Ubuntu系统：sudo apt install unzip
• Fedora/RHEL系统：sudo dnf install unzip
• macOS系统：xcode-select --install（如需命令行工具）

💡 提示：Linux系统若使用musl libc（如Alpine），需选择musl版本的Bun二进制文件。

二、多维度安装方案：选择最适合你的方式

Bun提供多种安装途径，可根据操作系统和个人偏好选择：

方案1：官方脚本一键安装（推荐）

Linux/macOS系统： 打开终端，输入以下命令：

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

Windows系统： 打开PowerShell，执行：

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

💡 提示：安装脚本MD5校验值：a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6（请通过官方渠道获取最新校验值）

方案2：包管理器安装

包管理器	安装命令	适用系统
npm	npm install -g bun	全平台
Homebrew	brew install oven-sh/bun/bun	macOS/Linux
Scoop	scoop install bun	Windows

方案3：源码编译安装

适合开发人员或需要自定义编译选项的场景：

第一步：克隆仓库

git clone https://gitcode.com/GitHub_Trending/bu/bun
cd bun

第二步：编译安装

make install

⚠️ 警告：源码编译需要Rust环境和CMake工具链，编译时间较长（约15-30分钟）。

方案4：Docker容器化安装

适合隔离环境或CI/CD场景：

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

三、验证与配置：确保Bun正常工作

安装完成后，需要验证安装并配置环境变量：

验证安装

第一步：检查版本 打开新终端，执行：

bun --version

如显示版本号（如1.0.2），表示安装成功。

第二步：运行测试程序 创建测试文件test.js：

console.log("Bun running:", Bun.version);

执行：

bun test.js

如输出Bun版本信息，说明运行正常。

环境变量配置

若出现"command not found"错误，需手动配置PATH：

Linux/macOS系统：

echo 'export BUN_INSTALL="$HOME/.bun"' >> ~/.bashrc
echo 'export PATH="$BUN_INSTALL/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Windows系统：

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

⚠️ 警告：环境变量配置后需重启终端或注销重新登录才能生效。

四、版本管理：升级、降级与多版本控制

Bun提供灵活的版本管理功能，满足不同开发需求：

版本升级

稳定版升级：

bun upgrade

包管理器用户：

• Homebrew：brew upgrade bun
• Scoop：scoop update bun

安装特定版本

Linux/macOS：

curl -fsSL https://bun.sh/install | bash -s "bun-v1.0.0"

Windows：

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

版本历史简表

版本	发布日期	主要变化
1.0.2	2023-11-15	修复Windows路径处理问题，提升HTTP性能
1.0.1	2023-10-20	改进TypeScript支持，修复测试运行器bug
1.0.0	2023-09-08	正式发布，支持完整的Node.js API兼容

尝鲜Canary版本

bun upgrade --canary

回退到稳定版：

bun upgrade --stable

五、问题处理：常见安装故障解决方案

常见问题速查

问题1：Linux系统提示"GLIBC版本不兼容"

• 解决方案：安装musl版本的Bun，或升级系统到较新的发行版

curl -fsSL https://bun.sh/install | bash -s -- --platform linux-x64-musl

问题2：Windows系统安装后命令无法识别

• 解决方案：手动检查环境变量配置，确保%USERPROFILE%\.bun\bin已添加到Path

问题3：npm安装方式提示权限错误

• 解决方案：使用npx临时运行或修复npm权限

npx bun --version
# 或修复npm权限
sudo chown -R $USER:$GROUP ~/.npm

问题4：编译安装时提示Rust版本过低

• 解决方案：使用rustup升级Rust

rustup update stable

问题5：Docker容器中运行提示内存不足

• 解决方案：增加容器内存限制

docker run --rm --init --ulimit memlock=-1:-1 -m 4g oven/bun

六、资源拓展：深入学习与社区支持

官方文档

完整安装指南：docs/installation.mdx

学习资源

• 快速入门教程：docs/quickstart.mdx
• API参考文档：docs/runtime/index.mdx
• 示例项目：examples/

社区支持

• 问题追踪：issues/
• 讨论论坛：discussions/
• 贡献指南：CONTRIBUTING.md

通过以上五个步骤，你已经掌握了Bun的安装配置和基本使用方法。Bun作为一款集多种功能于一体的现代化JavaScript工具链，其卓越的性能（如上图所示，Bun打包速度比Webpack快224倍）将显著提升你的开发效率。建议从官方示例项目开始实践，逐步探索Bun的强大功能。