概述

Bun 以單個無依賴的可執行文件形式發布。你可以在 macOS、Linux 和 Windows 上通過腳本、包管理器或 Docker 安裝它。

警告

安裝後，使用 bun --version 和 bun --revision 進行驗證。

安裝

macOS & Linux

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

警告

Linux 用戶 - 安裝 Bun 需要 unzip 包。使用 sudo apt install unzip 安裝 unzip 包。強烈建議內核版本 5.6 或更高，但最低要求是 5.1。使用 uname -r 檢查內核版本。

Windows

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

WARNING

Bun 需要 Windows 10 版本 1809 或更高版本。

如需支持和討論，請加入我們的 Discord 上的 #windows 頻道。

包管理器

npm install -g bun # 你需要的最後一個 `npm` 命令

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun 提供支持 Linux x64 和 arm64 的 Docker 鏡像。

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

鏡像變體

還有針對不同操作系統的鏡像變體：

docker pull oven/bun:debian
docker pull oven/bun:slim
docker pull oven/bun:distroless
docker pull oven/bun:alpine

要檢查 Bun 是否安裝成功，打開新的終端窗口並運行：

bun --version
# 輸出：1.x.y

# 查看你使用的 `oven-sh/bun` 的精確提交
bun --revision
# 輸出：1.x.y+b7982ac13189

WARNING

如果你已安裝 Bun 但看到 command not found 錯誤，你可能需要手動將安裝目錄（~/.bun/bin）添加到 PATH。

將 Bun 添加到 PATH

macOS & Linux

echo $SHELL
# /bin/zsh  或 /bin/bash 或 /bin/fish

打開你的 shell 配置文件

• 對於 bash：~/.bashrc
• 對於 zsh：~/.zshrc
• 對於 fish：~/.config/fish/config.fish

將 Bun 目錄添加到 PATH

將此行添加到你的配置文件：

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

重新加載你的 shell 配置

source ~/.bashrc  # 或 ~/.zshrc

Windows

& "$env:USERPROFILE\.bun\bin\bun" --version

如果命令成功運行但 bun --version 未被識別，這意味著 bun 不在你的系統 PATH 中。要修復此問題，打開 Powershell 終端並運行以下命令：

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

重啟終端

運行命令後，重啟終端並使用 bun --version 測試

bun --version

---

升級

安裝後，二進制文件可以自我升級：

bun upgrade

---

Canary 構建

-> 查看 canary 構建

Bun 會在每次提交到 main 分支時自動發布（未經測試的）canary 構建。要升級到最新的 canary 構建：

# 升級到最新 canary
bun upgrade --canary

# 切換回穩定版
bun upgrade --stable

canary 構建有助於在穩定版發布之前測試新功能和錯誤修復。為了幫助 Bun 團隊更快地修復錯誤，canary 構建會自動將崩潰報告上傳到 Bun 團隊。

---

安裝舊版本

由於 Bun 是單個二進制文件，你可以通過使用特定版本重新運行安裝腳本來安裝舊版本。

Linux & macOS

要安裝特定版本，將 git 標簽傳遞給安裝腳本：

curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"

Windows

在 Windows 上，將版本號傳遞給 PowerShell 安裝腳本：

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

---

直接下載

要直接下載 Bun 二進制文件，請訪問 GitHub 上的發布頁面。

最新版本下載

Linux x64

標准 Linux x64 二進制文件

Linux x64 Baseline

適用於沒有 AVX2 的舊 CPU

Windows x64

標准 Windows 二進制文件

Windows x64 Baseline

適用於沒有 AVX2 的舊 CPU

macOS ARM64

Apple Silicon (M1/M2/M3)

macOS x64

Intel Mac

Linux ARM64

ARM64 Linux 系統

Musl 二進制文件

對於沒有 glibc 的發行版（Alpine Linux、Void Linux）：

• Linux x64 musl
• Linux x64 musl baseline
• Linux ARM64 musl

TIP

如果你遇到類似 bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found 的錯誤，請嘗試使用 musl 二進制文件。Bun 的安裝腳本會自動為你的系統選擇正確的二進制文件。

---

CPU 要求

Bun 根據你使用的二進制文件有特定的 CPU 要求：

標准構建

x64 二進制文件 針對 Haswell CPU 架構（需要 AVX 和 AVX2 指令）

平台	Intel 要求	AMD 要求
x64	Haswell（第 4 代 Core）或更新	Excavator 或更新

Baseline 構建

x64-baseline 二進制文件 針對舊 CPU 的 Nehalem 架構

平台	Intel 要求	AMD 要求
x64-baseline	Nehalem（第 1 代 Core）或更新	Bulldozer 或更新

WARNING

Baseline 構建比普通構建慢。僅在遇到"Illegal Instruction"錯誤時使用它們。

::: note Bun 不支持舊於 baseline 目標的 CPU，這需要 SSE4.2 擴展。macOS 需要 13.0 或更高版本。 :::

卸載

要從系統中刪除 Bun：

macOS & Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

包管理器

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun