Bun
Bun 是面向 JavaScript 与 TypeScript 的一体化开发工具，集运行时、包管理器、脚本和测试运行器、打包器以及 bunx 包执行器于单个二进制文件。
适合做什么
Bun 适合用一个命令行工具运行 JavaScript/TypeScript、安装 npm 依赖、执行 package 脚本与测试、打包前端或服务端代码，并通过 bunx 运行包。它强调速度和 Node.js 兼容，但不能替代项目自身的兼容性与生产回归测试。
当前版本与平台
1.3.14 是 2026-05-13 发布的当前稳定版。官方提供 Windows、macOS、Linux 的 x64 与 ARM64 构建，并为旧 x64 CPU 提供 baseline 版本；项目 README 将 Windows、macOS 和 Linux 列为正式支持平台。
运行权限、依赖与许可边界
Bun 不是权限沙箱，安装脚本、项目脚本和 bunx 包能以当前用户权限访问系统。迁移前要固定版本、提交锁文件、审查生命周期脚本并验证原生模块。Bun 核心采用 MIT，但二进制静态链接 JavaScriptCore、WebKit 和其他多许可证组件，再分发时应保留完整 notices 和相应义务。
维护记录
本页于 2026-08-06 根据 Bun 1.3.14 发布资产、官方安装和工具说明、Node 兼容目标、CPU 与系统要求以及许可证清单复核。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
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 等不同条款。再分发二进制时要保留完整许可材料并核对重链接义务。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。