Bun 安装指南：三步玩转这款四合一 JavaScript 运行时

Bun 安装指南三步玩转这款四合一 JavaScript 运行时【免费下载链接】bunIncredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one项目地址: https://gitcode.com/GitHub_Trending/bu/bunBun 是一款集高性能运行时、包管理器、测试运行器与打包器于一体的 JavaScript 运行时。本安装指南带你完成 Bun 安装、验证到版本管理的全部流程macOS、Linux、Windows 一条命令即可上手。快速上手一条命令完成 Bun 安装最省事的路径是官方安装脚本它会自动识别你的操作系统与 CPU 架构下载对应预编译二进制并放入~/.bun。macOS / Linux 用户复制这条命令执行即可curl -fsSL https://bun.com/install | bash看到Bun was installed successfully之类的成功提示说明二进制已就位接着按第 3 节验证一次。Windows 用户请跳到下一节选对应命令。执行前两个小前提Linux 需要先有unzip包sudo apt install unzipWindows 需要 Windows 10 1809 或更高版本挑选你的 Bun 安装路径macOS / Linux3 种选法① 官方脚本推荐curl -fsSL https://bun.com/install | bash首次安装首选自动匹配架构Intel / Apple Silicon / ARM64后续bun upgrade自更新也最顺畅。② npm 全局安装npm install -g bun已经在用 npm 工作流时最顺手走的是 npm 的全局目录管理。③ HomebrewmacOSbrew install oven-sh/bun/bun习惯用 brew 统一管理工具的人选它升级要走brew upgrade bun。Windows3 种选法① PowerShell 一行流推荐powershell -c irm bun.sh/install.ps1|iex脚本会把 Bun 装到~/.bun/bin并尽量自动写入 PATH装完新开一个终端测试。② npm 全局安装npm install -g bun适合已配置好 Node.js 环境、想沿用 npm 全局目录的用户。③ Scoop 包管理器scoop install bunScoop 用户推荐用它安装卸载、更新都交给 Scoop 管理。安装后验证与 PATH 配置先打开一个新终端执行bun --version # 输出类似 1.4.0 bun --revision # 查看当前二进制对应的精确提交号看到版本号即安装成功。若提示command not found说明 Bun 装好了但所在目录不在 PATH 里按下面步骤配置。macOS / Linux 三步配好 PATH执行echo $SHELL确认自己的 shellbash / zsh / fish。打开对应配置文件bash 用~/.bashrczsh 用~/.zshrcfish 用~/.config/fish/config.fish。在文件末尾追加两行然后source重载配置export BUN_INSTALL$HOME/.bun export PATH$BUN_INSTALL/bin:$PATHsource ~/.bashrc # zsh 用户改为 source ~/.zshrc bun --version # 再验证一次Windows 一条 PowerShell 命令修复 PATH先用完整路径确认二进制本身没问题 $env:USERPROFILE\.bun\bin\bun --version能出版本号但直接敲bun不行就是 PATH 缺失。在 PowerShell 里执行下面这条把~\.bun\bin永久加入用户 PATH[System.Environment]::SetEnvironmentVariable( Path, [System.Environment]::GetEnvironmentVariable(Path, User) ;$env:USERPROFILE\.bun\bin, [System.EnvironmentVariableTarget]::User )重启终端后bun --version即可用。Bun 版本策略升级、锁定与 Canary自我升级安装脚本装出的 Bun 可以直接升级自身一条命令完成bun upgrade注意Homebrew / Scoop 用户请分别用brew upgrade bun、scoop update bun避免两个渠道互相覆盖。锁定特定版本Bun 是单一二进制重装时给脚本传版本号即可适合团队统一版本# macOS / Linux curl -fsSL https://bun.com/install | bash -s bun-v1.3.3 # Windows iex {$(irm https://bun.com/install.ps1)} -Version 1.3.3尝鲜 Canary 与回退main 分支每次提交都会产出一个未完整测试的 canary 构建bun upgrade --canary # 切到最新 canary bun upgrade --stable # 随时切回稳定版canary 会自动上传崩溃报告帮助定位问题因此只建议在开发环境试用生产环境请用稳定版。进阶场景Docker 镜像与 musl 二进制容器里跑 Bun官方镜像同时支持 x64 与 arm64拉下来直接运行docker pull oven/bun docker run --rm --init --ulimit memlock-1:-1 oven/bun不同基础系统有独立变体按体积和安全需求选docker pull oven/bun:debian # 默认 debian docker pull oven/bun:slim # 精简版 docker pull oven/bun:alpine # musl 基础极致轻量 docker pull oven/bun:distroless # 极简攻击面各变体的构建方式可参考仓库内的dockerhub/目录。musl 架构Alpine、Void 等没有 glibc 的发行版上若报GLIBC_... not found改用官方发布的 musl 版二进制x64 / arm64 均有放进任意 PATH 目录即可。正常情况下安装脚本会自动选对二进制无需手动干预。硬件与系统下限x64 构建基于 SSE4.2Nehalem微架构运行时自动启用 AVX2/AVX-512 路径无需挑选 baseline 版本Linux 内核建议 5.6最低 3.10 可降级运行用uname -r查看macOS 要求 13.0 及以上排障与移除常见问题和卸载方式症状原因与解法command not foundPATH 未包含~/.bun/bin按「验证与 PATH 配置」一节补上GLIBC_... not found系统无 glibc换 musl 版二进制安装脚本中途失败缺unzip执行sudo apt install unzip后重跑版本反复变化npm 全局与安装脚本装了两份卸载其一保留 PATH 中先出现的那个卸载按当初的安装方式选一条# 脚本安装macOS / Linux直接删除安装目录 rm -rf ~/.bun# 脚本安装Windows powershell -c ~\.bun\uninstall.ps1# npm 安装 npm uninstall -g bun # Homebrew 安装 brew uninstall bun # Scoop 安装 scoop uninstall bun脚本卸载后记得把之前手动加进 shell 配置的两行 PATH 也一并删掉。一条命令装好、验证、管版本——Bun 用一个二进制同时顶掉运行时、包管理、测试、打包四件套装完它你的下一个项目可以直接从bun开始写起。【免费下载链接】bunIncredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one项目地址: https://gitcode.com/GitHub_Trending/bu/bun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考