Electrobun 架构拆解TypeScript 怎么写出一个 MB 级桌面应用【免费下载链接】electrobunBuild ultra fast, tiny, and cross-platform desktop apps with Typescript.项目地址: https://gitcode.com/GitHub_Trending/el/electrobun打开一个 200MB 的安装包等进度条走完启动后窗口还要几秒才出来——对一个小工具来说这通常是传统桌面框架的默认配置。Electrobun 是一个跨平台桌面应用框架业务代码全部用 TypeScript 写主进程跑在 Bun 生态或其轻量替代上系统层用 Zig 编写安装包体在 MB 级而不是几百 MB。Electrobun 技术构成三层组合各拿什么收益先说结论这套组合的收益来自不打包浏览器——默认渲染直接复用用户系统里的 webviewmacOS 用 WKWebViewWindows 用 WebView2Linux 用 WebKitGTK即各操作系统自带的浏览器引擎组件只有显式打开bundleCEF时才把 Chromium 塞进安装包。应用层窗口、菜单、托盘、对话框、自动更新全部是 TypeScript API。运行时层主进程默认跑在 Cottontail 上——一个基于 JavaScriptCore、用 Zig 构建的小型运行时提供 Node.js 与 Bun 兼容的 API也可以直接用 Bun或换成 Rust、Go、Zig、Odin 当主进程。系统层Zig C Objective-C负责窗口系统、系统调用与性能关键路径。项目的吉祥物是一只兔子名字里的 bun 同时指向 Bun 运行时。 Electrobun 自底向上架构拆解从最底层讲起每层只回答两个问题负责什么为什么必须放在这一层。系统层启动与关键路径必须交给原生代码它负责应用的前两步和后一步第一步是启动器负责把进程拉起来中间是性能关键路径比如自解压安装包的解包最后是窗口系统、系统调用的对接。启动器代码在 package/src/launcher/自解压解包器在 package/src/extractor/用 Zstandard 压缩格式产出紧凑的分发包。必须在这一层的原因JS 运行时管不了 OS 资源启动阶段每多加载一点运行时用户就多等一点Zig 的零成本抽象和 C 互操作让这段代码既快又好写。对开发者意味着你一行原生代码都不用写但启动和解包这两段最影响体感的代码是原生的。运行时层主进程是应用的持有者它负责主进程的事件循环、异步操作以及和页面之间的类型化 RPC进程间通信参数带类型检查。必须在这一层的原因主进程拥有应用状态和所有原生对象页面被隔离在独立进程里只能通过 RPC 向主进程要服务——页面代码有 bug 或被人注入都够不到它从未被授予的 API。运行时本身做小Cottontail 比 Node 和 Bun 的完整运行时都小主进程的常驻占用也跟着小。对开发者意味着UI 随便用 Web 技术栈安全边界不用自己搭。应用层你只面对 TypeScript窗口、菜单、托盘、对话框、更新器都是 TS API窗口类的实现就一个文件package/src/sdks/main/core/BrowserWindow.ts。必须在这一层的原因把前两层彻底藏起来开发者只学一种语言。对开发者意味着学习成本是一个 Web 项目的成本不是一个原生项目的成本。 一次操作的全链路创建一个窗口按时间顺序跟一遍new BrowserWindow()之后发生的事应用层你的 TS 代码构造窗口传入尺寸、标题等参数。运行时层主进程把请求序列化经 FFI外部函数接口JS 与 C 代码之间的桥边界发给原生层参数在桥两侧都有类型检查。系统层Zig/C 包装器调用操作系统窗口 API系统创建真实窗口。页面系统 webview 加载你指定的 HTML与主进程隔离。事件回传ready、focus、resize 等事件从原生层沿事件桥回到运行时你在事件系统里订阅即可。对开发者意味着一行 API 背后是三层之间的类型化往返但你只需要看到第 1 步。 Electrobun 与 Electron 性能对比仓库文档的原话口径是measured in megabytes, not hundreds of them以 MB 计而不是几百 MB。可核实的数字如下维度Electrobun传统 Electron量级参考安装包体积Linux 原生包装器实测约 1.46MB系统 webview 版/ 约 3.47MB含 CEF 版出自仓库 BUILD.md通常几百 MB 级需自带完整 Chromium Node启动速度仓库未公布官方数字量级上省掉了加载整套浏览器运行时通常快得多通常需要先启动完整 Chromium增量更新通常 KB 级基于 Zig 优化的 BSDIFF 二进制差分通常 MB 级安装形态自解压 Zstandard 压缩通常为大体积传统安装包Electrobun 跨平台实现三方分工统一 API 抽象sdks/main下的 TypeScript API 在三个平台保持一致写一套代码。平台特定实现package/src/native/下分 linux、macos、win 三棵代码树Linux 没有可靠的弱链接机制所以构建产出 GTK 版和 CEF 版两套包装器打包时按配置二选一。构建脚本Hutch CLI 解析并下载所需工具链Zig、CEF 等一次跑完编译、签名与打包。 Electrobun 安装步骤三条命令跑起来前置一步先按仓库内docs/src/content/docs/electrobun/guides/hutch.mdx的说明全局安装 Hutch CLI。然后git clone https://gitcode.com/GitHub_Trending/el/electrobun cd electrobun/package npm ci hutch devhutch dev构建本地 devkit 并运行内置的 kitchen 测试应用。要开始自己的项目去templates/目录挑模板——从 hello-world、React、Svelte 到 Go、Rust、WGPU 共 30 多个最小入口看 templates/hello-world/。⚖️ Electrobun 适合谁双向判断适合需要 MB 级分发、启动快的小型工具类应用比如编辑器、客户端、效率软件已掌握 TS/Web 技术栈、不想再学一套原生开发的团队需要自动更新的产品更新器和 KB 级差分内置不用自研。不适合要求三个平台渲染像素级一致系统 webview 引擎各不相同要一致就得开bundleCEF体积随之涨上去深度依赖 Chromium 专有特性或指望一个十年成熟度的生态项目还年轻README 也明确写了维护者对社区 PR 不作响应承诺。你的下一步今天从templates/里拷一份 hello-world改一行窗口标题跑hutch dev。下午你手上就会有一个 MB 级的桌面应用而不是开头那个 200MB 的安装包。【免费下载链接】electrobunBuild ultra fast, tiny, and cross-platform desktop apps with Typescript.项目地址: https://gitcode.com/GitHub_Trending/el/electrobun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考