安裝
通過 npm、Homebrew、Docker 或官方指令碼安裝 Bun。
概述
Bun 以單個、無相依的執行檔形式提供。在 macOS、Linux 和 Windows 上，可以使用安裝指令碼、套件管理器或 Docker 進行安裝。
安裝
curl -fsSL https://bun.sh/install | bash
powershell -c "irm bun.sh/install.ps1|iex"
如需支援和交流，請加入 Discord 上的 #windows 頻道。
npm install -g bun # 這是你最後一次需要執行的 npm 命令
Homebrewbrew install oven-sh/bun/bun
scoop install bun
Bun 提供支援 Linux x64 和 arm64 的 Docker 映象。
docker pull oven/bun
docker run --rm --init --ulimit memlock=-1:-1 oven/bun
映象變體
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
將 Bun 新增到你的 PATH
- 確認你使用的是哪個 shellterminal
echo $SHELL # 可能輸出：/bin/zsh 或 /bin/bash 或 /bin/fish - 開啟你的 shell 設定檔
- bash 使用：
~/.bashrc - zsh 使用：
~/.zshrc - fish 使用：
~/.config/fish/config.fish
- bash 使用：
- 將 Bun 目錄新增到 PATH
將以下行新增到你的設定檔中：
terminalexport BUN_INSTALL="$HOME/.bun" export PATH="$BUN_INSTALL/bin:$PATH" - 重新載入你的 shell 設定terminal
source ~/.bashrc # 或者 ~/.zshrc
- 確認 bun 執行檔是否正確安裝terminal
& "$env:USERPROFILE\.bun\bin\bun" --version如果命令成功執行，但無法識別
bun --version，則說明 bun 不在系統的 PATH 中。要解決此問題，請開啟 PowerShell 終端並執行以下命令：terminal[System.Environment]::SetEnvironmentVariable( "Path", [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin", [System.EnvironmentVariableTarget]::User ) - 重啟你的終端
重啟終端，然後使用
bun --version進行測試。terminalbun --version
升級
安裝完成後，二進位制檔案可自動升級：
bun upgrade
Canary 版本
Bun 會在每次主分支提交時自動釋出（未經測試的）Canary 版本。要升級到最新 Canary 版本：
# 升級到最新 Canary
bun upgrade --canary
# 切換回穩定版本
bun upgrade --stable
使用 Canary 建置版本，可以在新功能和錯誤修復進入穩定版本之前進行測試。為了幫助 Bun 團隊更快地修復錯誤，Canary 建置版本會自動上傳崩潰報告。
安裝舊版本
由於 Bun 是單一的二進位制檔案，你可以通過重新執行安裝指令碼並指定版本安裝舊版本。
要安裝指定版本，將 git 標籤傳入安裝指令碼：
curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.3"
在 Windows 上，將版本號傳入 PowerShell 安裝指令碼：
iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.3.3"
直接下載
要直接下載 Bun 二進位制檔案，請訪問 GitHub 釋出頁面。
最新版本下載
glibc、Nehalem 或更新版本
ARM64 Linux 系統
Nehalem 或更新版本
適用於 ARM 架構（如驍龍等）的 Windows
Apple Silicon (M1/M2/M3)
Intel Mac
Musl 二進位制
適用於不支援 glibc 的發行版（如 Alpine Linux、Void Linux）：
CPU 要求
Bun 為每個平臺提供一個 x64 二進位制檔案。它以 Nehalem 微架構（SSE4.2）為目標，並在 CPU 支援時於執行環境選擇 AVX2/AVX-512 程式碼路徑，因此無需選擇單獨的“基準”下載版本。
| 平臺 | Intel 要求 | AMD 要求 |
|---|---|---|
| x64 | Nehalem（第 1 代 Core）或更新版本 | Bulldozer 或更新版本 |
解除安裝
要從系統中移除 Bun：
rm -rf ~/.bun
powershell -c ~\.bun\uninstall.ps1
npm uninstall -g bun
brew uninstall bun
scoop uninstall bun