bun 离线安装包

简介

Bun 是一个以单个、无依赖可执行文件形式发布的 JavaScript 与 TypeScript 运行时与工具链，面向需要在内网、离线或网络受限环境中部署开发工具的开发者。它把运行时、包管理器、打包器与测试运行器合并进同一个二进制文件，省去 Node.js 生态中多套工具组合的维护成本。离线场景下，只需提前在有外网的机器上下载对应平台的压缩包，再拷贝到目标机器解压，即可在无法访问外网的机器上直接运行，适合企业内网开发机、CI 构建缓存、教学机房批量分发等环境，也可作为 Windows 上不依赖 Node.js 的运行方案。

核心功能

• 单文件可执行程序：Bun 以名为 bun 的单一可执行文件发布，不需要外部运行时依赖，解压后执行 bun --version 即可确认文件是否可用。
• 内置包管理器：bun install 用于安装项目依赖，bun add 用于添加包，bun ls 查看已安装包，bun remove 移除包，目标是替代 npm、yarn、pnpm，并带高效缓存机制。
• 内置打包器：承担类似 Webpack 或 Vite 的打包职责，项目里不必再单独引入一套打包工具链。
• 内置测试运行器：可直接运行测试，不必再单独接入独立的测试框架生态。
• 运行 JavaScript 与 TypeScript：作为运行时直接执行 JS/TS 代码，bun create 可创建新项目。
• 跨平台分发：macOS、Linux、Windows 均可使用，官方提供安装脚本、包管理器与 Docker 三种在线获取方式，离线则走压缩包。

使用场景

• 内网或离线开发机：在外网机器上下载对应平台的压缩包，拷贝到无外网的机器解压即可运行，整个过程不依赖网络。
• CI/CD 构建环境：把 bun 可执行文件放入构建镜像或缓存目录，流水线直接调用，避免每次构建都去外网拉取工具链。
• 教学机房与批量分发：单个可执行文件便于复制到大量机器，统一目录与版本，便于集中管理和问题排查。
• Windows 上没有 Node.js 的机器：可直接使用可执行文件压缩包；机器上已有 Node 环境时，也可以走 npm 或 Scoop 方式获取。
• 从 Node.js 迁移的项目：同时需要运行时、打包、测试与包管理能力，希望用一套工具覆盖这些环节的场景。

安装与获取步骤

1. 在可联网的机器上获取对应平台的压缩包。Windows x64 的可执行文件压缩包地址形如 https://github.com/oven-sh/bun/releases/download/canary/bun-windows-x64.zip ，具体平台、通道与文件名以官方页面为准。
2. 解压压缩包。Linux 用户解压时需要 unzip 软件包，可先执行 sudo apt install unzip 准备该工具，再解压 Bun 的压缩包。
3. 把解压后的目录放到固定位置，示例做法是放到 D 盘并把文件夹改名为 bun；随后确认在终端中能直接调用 bun 命令，具体路径配置以官方页面为准。
4. 验证可用性：在终端执行 bun --version，能输出版本号即说明该可执行文件可正常运行；若提示找不到命令，说明命令搜索路径尚未覆盖该目录。
5. 有外网时的备选方式：执行 curl -fsSL https://bun.sh/install | bash 使用官方安装脚本；已有 Node 环境可用 npm install -g bun；习惯 Scoop 的可用 scoop install bun；也可使用 Docker 方式，详见 https://bun.com/docs/installation 。

常用命令速查

• bun --version：输出当前可执行文件的版本号，是离线机器上最直接的可用性检查。
• bun create：创建新项目，作为项目起步入口。
• bun install：安装项目依赖，走 Bun 内置的包管理器与缓存机制。
• bun add：把指定的包加入项目依赖。
• bun ls：查看当前已安装的包。
• bun remove：移除指定的包。

与同类方案的区别

• 对比 Node.js：Bun 以单个、无依赖的可执行文件分发，离线拷贝时只需带走一个文件，不必再带上一整套运行时依赖。
• 对比 npm、yarn、pnpm：Bun 把包管理器内置于同一个可执行文件中，bun install 直接完成依赖安装，并带高效缓存机制，减少重复下载。
• 对比 Webpack、Vite：Bun 内置打包器，打包与测试不再需要各自单独引入工具链，工具数量更少。
• 对比 Scoop、npm 等在线渠道：这些方式需要联网获取，适合有外网的机器；离线环境应提前下载压缩包，其余方式仅作备选。

注意事项

• Linux 上解压需要 unzip 软件包，若系统中没有，先执行 sudo apt install unzip 准备该工具，否则解压会直接失败。
• Linux 内核强烈建议使用 5.6 或更高版本，官方支持的最低版本为 5.1，低于该版本的内核不在支持范围内。
• 通过 npm install -g bun 方式获取的前提是本机已有 Node.js 环境；没有 Node 的机器应改用可执行文件压缩包或 scoop install bun。
• 素材中的压缩包地址指向 canary 通道的 GitHub Release 产物，链接与产物会随官方发布变化，长期脚本不要写死该地址。
• 本页未列出任何版本号、文件大小与校验值，相关参数一律以官方页面为准。