Bun 环境安装

本章介绍如何在不同操作系统上安装 Bun，以及安装后的验证和配置。

系统要求

Bun 支持以下操作系统：

操作系统	版本要求	架构
macOS	10.14+	x64, ARM64 (M1/M2)
Linux	glibc 2.17+	x64, ARM64
Windows	Windows 10+	x64
WSL	Ubuntu 20.04+	x64, ARM64

macOS / Linux 安装

方法一：官方安装脚本（推荐）

打开终端，运行以下命令：

bash

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

安装完成后，重启终端或运行：

bash

source ~/.bashrc  # Linux (bash)
source ~/.zshrc   # macOS (zsh)

方法二：使用 Homebrew（macOS）

bash

brew install oven-sh/bun/bun

方法三：使用 npm

如果已安装 Node.js：

bash

npm install -g bun

方法四：使用 Proto

bash

proto install bun

Windows 安装

方法一：PowerShell 安装（推荐）

以管理员身份打开 PowerShell：

powershell

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

方法二：使用 Scoop

powershell

scoop install bun

方法三：使用 npm

powershell

npm install -g bun

方法四：通过 WSL

在 WSL 中使用 Linux 安装方法：

bash

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

验证安装

安装完成后，验证 Bun 是否正确安装：

bash

# 查看版本
bun --version

# 输出示例
# 1.1.0

# 查看帮助
bun --help

快速测试

创建一个测试文件：

javascript

// test.js
console.log("Hello from Bun!");
console.log("Bun version:", Bun.version);

运行测试：

bash

bun test.js

输出：

Hello from Bun!
Bun version: 1.1.0

更新 Bun

使用内置命令更新

bash

bun upgrade

更新到特定版本

bash

bun upgrade --version 1.1.0

更新到最新测试版

bash

bun upgrade --canary

卸载 Bun

macOS / Linux

bash

# 删除 Bun 可执行文件
rm -rf ~/.bun

# 从 shell 配置中移除 PATH
# 编辑 ~/.bashrc 或 ~/.zshrc，删除 bun 相关行

Windows

powershell

# 删除 Bun 目录
Remove-Item -Recurse -Force $env:USERPROFILE\.bun

# 从环境变量中移除 PATH

通过包管理器卸载

bash

# Homebrew
brew uninstall bun

# Scoop
scoop uninstall bun

# npm
npm uninstall -g bun

配置环境变量

添加到 PATH

如果安装后命令未找到，需要手动添加 PATH：

Linux/macOS (bash):

bash

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

macOS (zsh):

bash

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

Windows PowerShell:

powershell

# 添加到用户 PATH
$env:BUN_INSTALL = "$env:USERPROFILE\.bun"
[Environment]::SetEnvironmentVariable("BUN_INSTALL", $env:BUN_INSTALL, "User")
[Environment]::SetEnvironmentVariable("PATH", "$env:BUN_INSTALL\bin;$env:PATH", "User")

Bun 配置文件

Bun 使用 bunfig.toml 作为配置文件：

toml

# bunfig.toml

# 包管理器配置
[install]
# 使用的 registry
registry = "https://registry.npmmirror.com"

# 安装时不保存到 package.json
save = false

# 开发依赖安装位置
dev = true

# 运行配置
[run]
# 静默模式
silent = false

# 测试配置
[test]
# 测试超时时间（毫秒）
timeout = 5000

# 覆盖率报告
coverage = true

配置文件位置

Bun 按以下顺序查找配置：

./bunfig.toml（当前目录）
$XDG_CONFIG_HOME/bun/bunfig.toml
~/.bunfig.toml

常见安装问题

问题 1：权限不足

bash

# Linux/macOS
curl -fsSL https://bun.sh/install | sudo bash

# 或更改安装目录权限
sudo chown -R $USER ~/.bun

问题 2：网络问题

使用镜像加速：

bash

# 使用国内镜像
curl -fsSL https://bun.sh/install | bash -s -- --mirror

问题 3：命令未找到

确保 PATH 配置正确：

bash

# 检查 Bun 安装位置
which bun
# 或
echo $BUN_INSTALL

问题 4：Windows 执行策略

powershell

# 临时允许脚本执行
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

IDE 支持

VS Code

安装 Bun 扩展获得更好的开发体验：

打开 VS Code 扩展市场
搜索 "Bun"
安装官方扩展

其他 IDE

WebStorm：原生支持 Bun
Vim/Neovim：使用 LSP 配置
Sublime Text：安装相关插件

小结

本章介绍了：

✅ 在 macOS、Linux、Windows 上安装 Bun
✅ 验证安装和版本管理
✅ 配置环境变量和配置文件
✅ 解决常见安装问题

下一步

安装完成后，继续阅读快速上手创建你的第一个 Bun 项目。

Bun 环境安装 ​

系统要求 ​

macOS / Linux 安装 ​

方法一：官方安装脚本（推荐） ​

方法二：使用 Homebrew（macOS） ​

方法三：使用 npm ​

方法四：使用 Proto ​

Windows 安装 ​

方法一：PowerShell 安装（推荐） ​

方法二：使用 Scoop ​

方法三：使用 npm ​

方法四：通过 WSL ​

验证安装 ​

快速测试 ​

更新 Bun ​

使用内置命令更新 ​

更新到特定版本 ​

更新到最新测试版 ​

卸载 Bun ​

macOS / Linux ​

Windows ​

通过包管理器卸载 ​

配置环境变量 ​

添加到 PATH ​

Bun 配置文件 ​

配置文件位置 ​

常见安装问题 ​

问题 1：权限不足 ​

问题 2：网络问题 ​

问题 3：命令未找到 ​

问题 4：Windows 执行策略 ​

IDE 支持 ​

VS Code ​

其他 IDE ​

小结 ​

下一步 ​

Bun 环境安装

系统要求

macOS / Linux 安装

方法一：官方安装脚本（推荐）

方法二：使用 Homebrew（macOS）

方法三：使用 npm

方法四：使用 Proto

Windows 安装

方法一：PowerShell 安装（推荐）

方法二：使用 Scoop

方法三：使用 npm

方法四：通过 WSL

验证安装

快速测试

更新 Bun

使用内置命令更新

更新到特定版本

更新到最新测试版

卸载 Bun

macOS / Linux

Windows

通过包管理器卸载

配置环境变量

添加到 PATH

Bun 配置文件

配置文件位置

常见安装问题

问题 1：权限不足

问题 2：网络问题

问题 3：命令未找到

问题 4：Windows 执行策略

IDE 支持

VS Code

其他 IDE

小结

下一步