Bun
Bun 是面向 JavaScript 与 TypeScript 的一体化开发工具，集运行时、包管理器、脚本和测试运行器、打包器以及 bunx 包执行器于单个二进制文件。
适合做什么
Bun 用一个命令行工具覆盖 JavaScript/TypeScript 运行时、npm 依赖安装、package 脚本、测试、打包和 bunx 临时执行。它适合新项目快速建立统一工具链，也适合在隔离分支中评估现有 Node 项目是否能迁移。运行快不等于兼容性自动成立，原生扩展、模块格式和生命周期脚本仍需逐项回归。
当前版本与平台
1.3.14 是 2026-05-13 发布的稳定版，提供 Windows、macOS、Linux 的 x64 与 ARM64 构建，并为旧 x64 CPU 提供 baseline 版本。安装后除了核对版本，还要确认终端实际命中的路径、CPU 架构和 lockfile 变化。生产项目应在 CI 和容器中固定版本，保留原 Node.js 流程作为回滚基线。
运行权限、依赖与许可边界
Bun 不是权限沙箱，安装脚本、package 脚本和 bunx 包可按当前用户权限访问文件、网络、环境变量和子进程。使用 bunx 前核对包名、维护者和版本，依赖安装要审查来源与生命周期脚本。Bun 核心采用 MIT，但静态链接组件有各自许可证，再分发二进制时应保留 notices。
维护记录
本页于 2026-08-23 根据 Bun 1.3.14 发布资产、安装和工具说明、Node 兼容目标、CPU 与系统要求以及许可证清单复核。
保存到自己的网盘
打开网盘后可直接获取，也可以先保存到自己的网盘，方便换设备继续使用。
夸克网盘（无需提取码）
推荐将「Bun」保存到该网盘
百度网盘
将「Bun」保存到该网盘
Bun 1.3.14 安装、项目试跑与兼容性验证教程
下面使用直接下载的稳定版二进制创建隔离测试项目，验证依赖锁定、脚本、测试和构建，再决定是否替换现有 Node.js 工具链。
安装前准备
- 准备 Windows、macOS 或 Linux 对应 CPU 架构；较旧 x64 CPU 应选择 baseline 构建，Linux 推荐内核 5.6 以上且最低为 5.1。
- 复制现有项目到独立分支或测试目录，保留原 Node.js 版本、锁文件和 CI 基线。
- 清理终端中的生产密钥，第三方安装脚本和 bunx 包都按本机用户权限执行。
安装步骤
- 01
选择稳定版与正确架构
下载 1.3.14 对应 Windows、macOS 或 Linux ZIP，按 x64、ARM64 及 CPU 指令集选择普通或 baseline 构建。不要将 canary 当作生产稳定版。
- 02
验证版本和可执行路径
解压到受控工具目录，把该目录加入当前用户 PATH，重新打开终端后核对版本与实际可执行文件位置，避免同时命中旧安装。
- 03
在隔离目录安装依赖
先保存现有锁文件和依赖树，再使用 Bun 安装。检查锁文件变更、解析来源、生命周期脚本和私有仓库认证，不直接在生产工作区首次尝试。
快速上手
- 01
运行脚本与测试套件
对照原工具执行 package 脚本和完整测试，比较退出码、快照、时间、内存及网络行为。不能用启动成功替代兼容性结论。
- 02
验证构建与部署产物
检查 bundler 输出、source map、环境变量、动态导入、原生模块和目标平台，在与生产一致的容器或主机上启动烟雾测试。
- 03
固定版本并保留回滚
在 CI、开发文档和镜像中固定经过验证的 Bun 版本，提交锁文件并保留原 Node.js 流程，升级时先阅读破坏性变更和安全修复。
使用建议
- bunx 会下载并执行包，名称拼写错误可能触发恶意相似包；先核对包名、维护者、版本和完整依赖树。
- Bun 会参与解析环境变量和 package 脚本，日志、错误上报与构建产物都不应包含生产秘密。
- 快速安装和运行不等于依赖可信，应启用锁文件、来源限制、依赖审计和 CI 最小权限。
故障排查与卸载方法
启动提示 illegal instruction 怎么办？
当前 x64 CPU 可能不支持普通构建所需指令集，应改用对应 baseline 资产并核对系统架构。不要下载来路不明的重新打包版本。
Node 项目在 Bun 中测试失败怎么办？
缩小到具体 Node API、模块格式、原生扩展或脚本差异，保留最小复现并继续用已验证的 Node 版本运行生产。不要用跳过失败测试作为迁移完成证明。
- 恢复原工具链与锁文件切回原 Node.js 版本，按项目决定保留或还原 Bun 锁文件，重新安装依赖并运行测试，确认开发与 CI 都已回到已知状态。
- 删除二进制和全局缓存从 PATH 移除 Bun 工具目录，再清理不需要的全局包、缓存和下载资产；私有仓库令牌应从配置和终端历史中撤销或轮换。
常见问题
Bun 可以无修改替代所有 Node.js 项目吗？
不能保证。它面向 Node.js 兼容，但原生扩展、边缘 API、工具链假设和运行时行为仍可能不同。生产迁移必须运行项目自己的测试、性能和回滚验证。
Bun 运行第三方代码时有沙箱吗？
没有 Deno 式默认权限沙箱。脚本、依赖和 bunx 启动的包可按当前系统用户权限访问文件、网络、环境变量和子进程，应把它们当作普通可执行代码审查。
Bun 全部只采用 MIT 许可证吗？
Bun 自身核心采用 MIT，但静态链接的 JavaScriptCore、WebKit 和其他组件包含 LGPL、Apache、BSD 等不同条款。再分发二进制时要保留完整许可材料并核对重链接义务。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。