垦荒学园
  • 中文

      • Bun 环境安装

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

      系统要求

      Bun 支持以下操作系统：

      操作系统版本要求架构
      macOS10.14+x64, ARM64 (M1/M2)
      Linuxglibc 2.17+x64, ARM64
      WindowsWindows 10+x64
      WSLUbuntu 20.04+x64, ARM64

      macOS / Linux 安装

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

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

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

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

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

      方法二：使用 Homebrew（macOS）

      brew install oven-sh/bun/bun

      方法三：使用 npm

      如果已安装 Node.js：

      npm install -g bun

      方法四：使用 Proto

      proto install bun

      Windows 安装

      方法一：PowerShell 安装（推荐）

      以管理员身份打开 PowerShell：

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

      方法二：使用 Scoop

      scoop install bun

      方法三：使用 npm

      npm install -g bun

      方法四：通过 WSL

      在 WSL 中使用 Linux 安装方法：

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

      验证安装

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

      # 查看版本
bun --version

# 输出示例
# 1.1.0

# 查看帮助
bun --help

      快速测试

      创建一个测试文件：

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

      运行测试：

      bun test.js

      输出：

      Hello from Bun!
Bun version: 1.1.0

      更新 Bun

      使用内置命令更新

      bun upgrade

      更新到特定版本

      bun upgrade --version 1.1.0

      更新到最新测试版

      bun upgrade --canary

      卸载 Bun

      macOS / Linux

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

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

      Windows

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

# 从环境变量中移除 PATH

      通过包管理器卸载

      # Homebrew
brew uninstall bun

# Scoop
scoop uninstall bun

# npm
npm uninstall -g bun

      配置环境变量

      添加到 PATH

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

      Linux/macOS (bash):

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

      macOS (zsh):

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

      Windows 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 作为配置文件：

      # bunfig.toml

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

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

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

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

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

# 覆盖率报告
coverage = true

      配置文件位置

      Bun 按以下顺序查找配置：

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

      常见安装问题

      问题 1：权限不足

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

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

      问题 2：网络问题

      使用镜像加速：

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

      问题 3：命令未找到

      确保 PATH 配置正确：

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

      问题 4：Windows 执行策略

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

      IDE 支持

      VS Code

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

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

      其他 IDE

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

      小结

      本章介绍了：

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

      下一步

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