Bun 打包二进制如何还原成 JavaScript？TheCjw/extract_bun.js 使用教程
关键词
Bun二进制还原、Bun extract_bun.js、Bun打包反编译、Bun打包为exe、Bun提取JavaScript源码、TheCjw extract_bun.js、Bun单文件应用
很多开发者都会使用Bun的单文件打包功能，将 JavaScript 项目打包成一个独立的可执行文件（Windows 下为 exe，Linux/macOS 下为可执行二进制）。
那么有没有办法把这些 Bun 打包出来的二进制，再恢复成 JavaScript 呢？
最近 GitHub 上发现了一个非常实用的小工具：
TheCjw/extract_bun.js
它可以从Bun 打包生成的二进制文件中提取 JavaScript 代码，对于学习、调试、分析自己的程序都很有帮助。
一、什么是 extract_bun.js
项目地址：
https://gist.github.com/TheCjw/2665020a559c1e980fa10f2a5c2aa621
这是一个只有一个 JS 文件的小工具。
它的作用就是：
- 提取 Bun Binary 中的 JavaScript
- 恢复 Bun Bundle 内容
- 导出打包进去的源码
- 支持 Bun 打包生成的单文件程序
整个工具非常轻量，不需要复杂安装。
二、Bun 的单文件打包是什么
很多人应该都用过：
bun build index.ts--compile或者
bun build app.js--compile最终会得到一个：
Windows
app.exeLinux
appmacOS
app实际上里面除了 Bun Runtime 外，还包含了：
- JavaScript
- TypeScript 编译后的代码
- Bundle
- 资源文件
因此理论上是能够提取出来的。
三、extract_bun.js 可以做什么
目前主要用途包括：
1、恢复 JavaScript
把 Bun Binary 中存储的 JS 导出来。
例如：
app.exe ↓ index.js utils.js config.js ...2、分析 Bundle
如果想了解：
- Bun 如何打包
- Bundle 的组织方式
- Runtime 加载逻辑
这个工具也可以作为分析入口。
3、学习开源程序
如果作者提供的是 Bun Binary，而不是源码。
可以用于：
- 学习实现思路
- 查看代码结构
- 分析依赖关系
当然，前提是符合软件许可协议以及相关法律法规，仅用于合法用途。
四、如何使用
首先下载：
extract_bun.js然后执行：
nodeextract_bun.js your_program.exe或者
bun extract_bun.js your_program.exe运行完成后，会在当前目录生成提取出来的 JavaScript 文件。
不同 Bun 版本打包格式可能存在差异，因此具体输出结果会受到 Bun 版本影响。
五、支持哪些 Bun 程序
理论上支持 Bun 的 Binary Compile。
例如：
bun build --compile生成的单文件程序。
如果 Bun 后续修改了 Binary 格式，脚本可能需要同步更新。
六、适合哪些场景
这个工具比较适合：
- 学习 Bun Binary 结构
- 调试自己的程序
- 分析 Bundle 内容
- 安全研究
- 逆向工程学习
- 了解 Bun Compile 的实现方式
对于 Bun Runtime 的内部实现也有一定参考价值。
七、需要注意的问题
虽然可以提取 JavaScript，但并不意味着一定能够完全恢复项目。
例如：
- 已经过压缩
- 已经混淆
- 动态生成代码
- Native 插件
- 外部资源
这些内容可能无法完全恢复。
另外，如果程序作者进行了额外加密处理，也会影响最终提取效果。
因此恢复结果主要取决于原始打包方式以及 Bun 的版本。
八、总结
TheCjw/extract_bun.js是一个非常实用的小工具，它能够帮助开发者从 Bun 编译生成的二进制程序中提取 JavaScript 代码，对于学习 Bun 的打包机制、调试自己的程序以及分析 Bundle 结构都有一定参考价值。
随着越来越多项目开始采用 Bun 的--compile功能发布单文件应用，这类工具也为开发者理解 Bun 二进制格式提供了新的思路。当然，在使用时仍应遵守软件许可协议和相关法律法规，仅对自己拥有权限的软件或获得授权的程序进行分析。
如果你正在研究 Bun 的打包机制，或者想了解单文件可执行程序内部到底包含了什么，不妨体验一下这个脚本。
项目地址
| 名称 | 地址 |
|---|---|
| extract_bun.js | https://gist.github.com/TheCjw/2665020a559c1e980fa10f2a5c2aa621 |
文章总结
本文介绍了 GitHub 上的TheCjw/extract_bun.js工具，它可以从 Bun--compile打包生成的单文件二进制程序中提取 JavaScript 代码，并介绍了适用场景、基本使用方式以及相关注意事项，适合作为学习 Bun 打包机制和分析 Binary 结构的参考工具。
