北城笑笑头像
Vue 108 ,Electron 开源项目 Star TOP10:哪些桌面应用值得研究?( Vue + Electron )封面图

Vue 108 ,Electron 开源项目 Star TOP10:哪些桌面应用值得研究?( Vue + Electron )

前言

GitHub 上带 electron 主题标签的仓库合计有 4.3M 颗星,分布在 263 个活跃项目里。但“带 Electron 标签”和“值得研究”之间隔着一道很宽的沟。有的项目是 UI 库,有的项目是测试工具,它们用了 Electron 的生态,但本身并不是一个桌面应用。另一些项目确实是完整的产品级桌面应用,代码结构和安全模型经过了大量用户的检验,读它们的源码和读一份“最佳实践文档”是两种完全不同的体验。

这篇按 Star 数从高到低 筛出真正用 Electron 构建的桌面应用,逐个拆技术栈、架构特点和二次开发可行性。更重要的是,每个项目都给出仓库地址、本地运行步骤和依赖安装时真正会卡住的地方。 读完你能判断:哪个项目的哪一部分值得抄、哪个项目的哪一层最好不要碰、以及“开源”和“能拿来改”之间差的是什么。

本文的主榜口径是:项目主交付物为可运行的桌面应用,且桌面壳层使用 Electron。 框架本身、UI 组件库、自动化测试工具不进入主榜,避免读者误以为它们是可以直接“拿来改”的桌面应用源码。

在这里插入图片描述

图1 封面图

一、榜单的筛选口径:什么算“Electron 开源项目”

GitHub 的 electron 主题下,排名前列的仓库性质差别很大。直接按星数拉一个列表,前几名里会混进 UI 组件库和自动化测试框架,它们是“Electron 生态的依赖”,不是“用 Electron 构建的应用”。

本文采用的口径是:项目的主交付物是一个可运行的桌面应用程序,且桌面壳层使用 Electron。框架本身 electron/electron 不计入应用榜单,但在后文单独说明它的位置。生态工具如 Playwright、Ant Design 不进入主榜,避免读者误以为它们是可以“拿来改”的桌面应用源码。

按这个口径,截至 2026 年 10 月前后,用 Electron 构建的桌面应用 Star 排名大致如下:

排名项目Star 数(约)仓库地址渲染层技术栈包管理器
1microsoft/vscode194Khttps://github.com/microsoft/vscode自研 UI 体系npm
2debpalash/VoiceStudio100Khttps://github.com/debpalash/VoiceStudio信息未完全公开Bun + uv
3Eugeny/tabby75Khttps://github.com/Eugeny/tabbyAngularYarn
4toeverything/AFFiNE73.7Khttps://github.com/toeverything/AFFiNEReactYarn
5jgraph/drawio-desktop63.6Khttps://github.com/jgraph/drawio-desktop原生 JSnpm
6marktext/marktext62.8Khttps://github.com/marktext/marktextVue 3pnpm
7atom/atom60.7Khttps://github.com/atom/atom自研已归档
8agalwood/Motrix57.1Khttps://github.com/agalwood/Motrix信息未完全公开npm / Yarn / pnpm
9laurent22/joplin56.8Khttps://github.com/laurent22/joplinReact Native / ElectronYarn
10lyswhut/lx-music-desktop54.6Khttps://github.com/lyswhut/lx-music-desktopVuenpm

数据来源为 GitHub 主题聚合站点在 2026 年 10 月前后的快照,Star 数会随时间波动,量级参考即可。Star 数反映的是产品影响力和社区认可,不等于代码的可移植性,更不等于“clone 下来就能跑”。 这个判断在后面的本地运行章节里会反复用到。

在这里插入图片描述

图2 榜单结构示意图

二、TOP10 逐个拆解:技术栈、架构与“能不能改”

2.1 VS Code(194K):不是“Electron 应用”,是“把 Electron 用到了极限的系统”

VS Code 常被当作“Electron 能做高性能应用”的证据,但它的性能来源不在 Electron 本身。它的文本缓冲区经历过一次重写,从“每行一个对象”的 line array 模型切换为 Piece Tree,才撑住了千万行级文件;启动阶段用 V8 startup snapshots 绕开同步 require() 的瓶颈。这两件事都和 Electron 无关,是上层工程决策。

架构上,VS Code 的关键设计是 进程隔离。Extension Host 运行在一个独立的 Node.js 进程中,插件代码崩溃不会拖垮渲染进程;LSP(Language Server Protocol) 把语言智能从编辑器中解耦,语言服务器可以独立部署、独立升级。Monaco 编辑器内核则被抽成可复用的组件,脱离了 VS Code 外壳也能单独使用。

本地运行门槛:高。 源码构建需要 Node.js、Python、C++ 编译器,Windows 上还要装 Visual Studio Build Tools,编译阶段 Node.js 堆内存可能跑到 8 GB。npm install 之后还要单独执行 npm run electron 下载 Electron 二进制。运行开发版用 ./scripts/code.sh(macOS/Linux)或对应脚本,不是简单的 npm start。

二次开发可行性:低。 不是说 MIT 协议不允许你 fork,而是你拿到的是一套为“可扩展编辑器”设计的、高度抽象的系统。改一行 UI,可能需要理解 Monaco 的模型层、Extension Host 的通信协议和 Electron 主进程的窗口管理三套系统。研究它的 LSP 解耦方式和进程隔离设计,比直接改它的业务代码有价值得多。

2.2 VoiceStudio(100K):Electron 壳里装了一个本地 AI 推理栈

VoiceStudio 的定位是“完全本地的 ElevenLabs 替代品”,覆盖语音克隆、语音设计、视频配音、听写、转录和有声音频制作。它的主语言是 Python,说明核心推理逻辑不在 Electron 层,Electron 承担的是界面和进程编排。

本地运行的关键步骤:它用 Bun 作为包管理器,并且需要 uv 来准备 Python 依赖。顺序不能反:先 bun install,再 bun run setup:api 准备 Python 后端,最后才是 bun run dev 启动 Electron。跳过 setup:api 直接 bun run dev,Electron 窗口会起来,但后端推理进程没就绪,功能是空的。 这是这类“重后端”项目最常见的坑。

二次开发可行性中等:界面层和 Electron 壳层可以替换,但真正的价值在 Python 推理管线里,改 UI 容易,改模型难。

2.3 Tabby(75K):Angular + 插件化,终端类应用的工程范本

Tabby(原名 Terminus)是一个高度可配置的终端模拟器、SSH 和串口客户端,前端用 Angular,终端渲染层基于 xterm.js 并启用 WebGL 加速。它的架构亮点是 插件系统:连接类型本身就以插件形式实现,第三方可以通过 npm 包扩展新功能或新主题。

克隆时必须加 --recurse-submodules。 Tabby 的推理后端依赖 llama.cpp,它以 git 子模块的形式挂在仓库里,漏掉这个参数,后续编译会缺 C++ 源码。依赖安装用 Yarn,Node.js 版本建议 15 以上。如果已经克隆但没拉子模块,用 git submodule update --recursive --init 补上。

这是一个把“可配置”和“可扩展”做进架构骨子里的项目。研究它的插件加载机制和连接抽象层,对做工具类 Electron 应用有直接参考价值。二次开发可行性中偏高:Angular 的技术栈对国内 Vue/React 开发者有一定门槛,但插件边界清晰,想加一个自定义连接协议,不需要动核心代码。

2.4 AFFiNE(73.7K):用 NestJS 的思路组织 Electron 主进程

AFFiNE 的定位是“Notion + Miro”的隐私优先替代品,文档、白板、表格合为一体。它最特殊的设计在主进程:Electron 主进程和 helper 进程都被组织成 NestJS 应用,用模块、服务、依赖注入来管理业务逻辑,而不是把所有逻辑塞进 main.js。它还自建了一套 类型安全的 IPC 系统,通过装饰器在构建时生成 TypeScript 类型。

本地运行不是单命令。 AFFiNE 的 Electron 桌面端是 monorepo 中的一个子应用,需要先在仓库根目录 yarn install,然后进入 packages/frontend/apps/electron 执行 yarn generate-assets 和 yarn dev。如果 yarn install 阶段 Electron 下载卡住,可以设置 ELECTRON_MIRROR 指向国内镜像。AFFiNE 的 Web 层和 Electron 层是分开启动的,调试桌面端时往往需要两个终端。

这套架构的代价是复杂度。如果你只是做一个三五个窗口的小工具,NestJS + 自定义 IPC 代码生成属于过度设计。但如果你在做一个模块数量多、团队规模大、主进程逻辑重的桌面应用,AFFiNE 的主进程组织方式值得认真读。二次开发可行性低到中:它的 Web 部分本身就可独立运行,Electron 是封装层;想基于它做产品,更现实的路径是复用 Web 层,重写桌面壳。

2.5 drawio-desktop(63.6K):最“薄”的 Electron 封装,也是最好的安全参考

jgraph/drawio-desktop 的自我描述很直白:“Official electron build of draw.io”。它没有把 draw.io 的编辑器代码搬进仓库,而是用 Electron 包裹核心 draw.io 编辑器,并做了完全的网络隔离以保证离线安全。

克隆同样必须递归:核心 draw.io 编辑器是 git 子模块,git clone --recursive https://github.com/jgraph/drawio-desktop.git 是唯一正确的起点,普通 git clone 得到的仓库构建会失败。依赖用 npm 安装,npm start 即可运行;开发模式加 DRAWIO_ENV=dev 可以打开 DevTools。Node.js 要求 22.12+。

这个项目的价值不在“代码量”,而在 Electron 壳层的配置方式。它演示了如何在不重写业务前端的前提下,用 Electron 的安全选项把一个纯 Web 应用变成一个可离线运行、边界清晰的桌面应用。如果你的目标是把已有的 Web 项目桌面化,drawio-desktop 的壳层配置是最接近“模板”的参考。

2.6 MarkText(62.8K):Vue 3 + Electron 的完整工程切片

MarkText 是一个所见即所得的 Markdown 编辑器,Electron + Vue 3 构建,技术栈包括 electron-vite、electron-builder、Pinia、Element Plus,包管理器是 pnpm。

依赖安装的三个硬前提:Python >=3.12,Node.js >=20.19.0(官方 CI 用 Node 22 和 24),Windows 上需要 Visual Studio 2022 Build Tools 并且勾选 Spectre-Mitigated MSVC 库。克隆后先 pnpm install,开发前建议跑一次 pnpm run minify-locales,然后 pnpm run dev 启动。主进程和 preload 的热更新不是自动的,改这两部分的代码需要手动重载开发进程;渲染进程虽然热更新,但状态丢失后容易出现诡异错误,必要时全量重启。

对 Vue 开发者来说,MarkText 是这份榜单里**技术栈最“对味”**的项目。它的目录结构、IPC 约定、构建配置,都可以直接对照到自己的 Vue + Electron 项目里。二次开发可行性中偏高:业务代码可读性远高于 VS Code,但同样需要面对 Electron 安全模型和签名分发链路的重建。

2.7 Atom(60.7K):已归档,但“可黑客”的设计思路仍在

Atom 是 Electron 早期的旗舰应用,现已归档,Star 数停在 60.7K。它的技术栈带有明显的时代印记(CoffeeScript、早期的 Electron API),不建议作为新项目的直接参考,更不建议花时间配环境去跑它。Node.js 版本和原生模块的兼容性在今天已经很难复现。但 Atom 提出的“可黑客编辑器”理念影响了后来很多工具类应用的设计,读它的包系统设计,仍然能理解“桌面应用的可扩展性”应该往哪个方向做。

2.8 Motrix(57.1K):下载管理器的 Electron 实现

Motrix 是一个支持 HTTP、FTP、BitTorrent 和磁力链接的下载管理器,用 TypeScript 构建。主进程需要管理外部下载引擎进程(aria2),渲染进程负责任务列表和速度展示。

包管理器相对宽松:npm、Yarn、pnpm 都可以用。npm install 后 npm run dev 启动开发模式,npm run build 打包。如果 Electron 二进制下载慢,设置 electron_mirror 环境变量指向国内镜像即可。这种“Electron 做界面 + 外部二进制做重活”的模式,和 VoiceStudio 类似,但依赖链轻得多。二次开发可行性中等:下载引擎是现成的,改界面和任务管理逻辑相对直接。

2.9 Joplin(56.8K):一套逻辑,多端桌面

Joplin 是注重隐私的笔记与待办应用,支持端到端加密和同步,覆盖 Windows、macOS、Linux、Android、iOS。它的架构特点是 React Native 与 Electron 共享大量业务逻辑,Electron 只是桌面端的渲染和打包层。

本地构建的前提条件写在 devbox.json 里,官方推荐用 Yarn 安装依赖。Joplin 的 monorepo 结构意味着你不能只在一个子包里 yarn install,需要在正确的层级执行,并且桌面端、移动端、CLI 的构建入口各不相同。Joplin 的同步和加密模块是与平台无关的共享逻辑,也是耦合最紧的部分;界面层可以动,底层协议不建议轻易改。

2.10 lx-music-desktop(54.6K):国内 Vue 技术栈的 Electron 音乐播放器

lyswhut/lx-music-desktop 是一个基于 Electron 30+ 和 Vue 3 的音乐软件,包管理器用 npm,Node.js 要求 >=22,npm >=8.5.2,用 better-sqlite3 做本地存储。

国内用户最实用的一个配置:安装依赖前先设 Electron 镜像,否则二进制下载会卡很久:

npm config set electron_mirror=https://npmmirror.com/mirrors/electron/
npm install
npm run dev

npm run dev 是开发模式,npm run pack:dir 构建免安装版,npm run pack 构建安装包。对国内开发者来说,它的中文文档和 Vue 技术栈亲和度最高,是这份榜单里“第一次跑起来”成本最低的 Vue + Electron 项目之一。音乐源相关的逻辑涉及第三方服务,改动时需要自行评估合规边界。

在这里插入图片描述

图3 技术栈分布示意图

三、下载到本地之后:运行、依赖安装与查看说明的通用方法

3.1 克隆之前先看三样东西

第一看 README 和 CONTRIBUTING。 几乎所有项目的本地运行步骤都不在主 README 的显眼位置,而是在 CONTRIBUTING.md、docs/dev/、BUILD.md 或 .github/CONTRIBUTING.md 里。MarkText 的开发文档在 packages/website/content/docs/dev/README.md;Joplin 的构建说明在 BUILD.md;drawio-desktop 的构建细节甚至放在 CLAUDE.md 里。只读 README 就开始 npm install,是跑不起来的第一大原因。

第二看 package.json 的 engines 字段和 packageManager 字段。 它直接告诉你 Node.js 最低版本和包管理器类型。lx-music 写明 Node >=22、npm >=8.5.2;drawio-desktop 要求 Node 22.12+;MarkText 要求 Node >=20.19.0。用低于要求的 Node 版本去装依赖,原生模块(尤其是 better-sqlite3、node-pty 这类)编译失败几乎是必然的。

第三看有没有 .gitmodules 或 --recursive 提示。 Tabby 和 drawio-desktop 都依赖子模块,普通 git clone 拿到的代码是不完整的。

3.2 依赖安装阶段的真实卡点

Electron 二进制下载慢或失败是国内环境最高频的问题。各个项目的解法本质相同:设置 ELECTRON_MIRROR 环境变量。AFFiNE 的文档直接给出了镜像写法 export ELECTRON_MIRROR="https://registry.npmmirror.com/-/binary/electron/";lx-music 用 npm config set electron_mirror。镜像地址必须指向 Electron 二进制目录,而不是普通的 npm registry。

原生模块编译失败在 Windows 上尤其常见。MarkText 明确要求 Visual Studio 2022 Build Tools + Spectre-Mitigated MSVC 库,并且 .npmrc 里强制使用 MSVC 而不是 ClangCL。VS Code 的 Windows 构建同样需要 Visual Studio Build Tools,还会遇到 v141 工具集找不到这类经典报错。如果你在 Windows 上看到 node-gyp 或 MSB 开头的报错,先检查 Build Tools 和 Python 是否装齐,而不是反复重试 npm install。

Python 版本也可能卡住。 MarkText 要求 Python >=3.12,VS Code 的构建过程也需要 Python 来编译原生模块。Python 2.7 时代的老教程不要照搬。

包管理器选错会导致 lockfile 冲突。 项目用什么,你就用什么。MarkText 用 pnpm,Tabby 和 AFFiNE 用 Yarn,VoiceStudio 用 Bun,Joplin 用 Yarn。在 pnpm 项目里跑 npm install,虽然有时能装上,但生成的依赖树和 lockfile 可能与官方 CI 不一致,遇到问题时很难排查。

3.3 运行和调试阶段的注意事项

开发模式和打包模式的入口不同。 大多数项目 npm run dev 或 yarn dev 是开发模式,带热更新;npm run build / yarn make 是打包。但 VS Code 的开发入口是 ./scripts/code.sh,AFFiNE 需要进入 apps/electron 子目录再执行 yarn dev,drawio-desktop 是 npm start。不要假设所有 Electron 项目的启动命令都是 npm start。

主进程和 preload 的改动通常不热更新。 MarkText 的开发文档写得很直接:main 和 preload 进程编辑后不会自动热加载,需要手动重载开发进程;渲染进程虽然热更新,但状态丢失后可能出现奇怪错误,建议全量重启。这个规律对其他项目也基本适用。

“能启动窗口”不等于“项目跑通了”。 VoiceStudio 如果跳过 setup:api,Electron 窗口能弹出来,但 AI 后端是空的。AFFiNE 如果只启动了 Web 层而没启动 Electron 子应用,你看到的是浏览器页面而不是桌面窗口。判断标准应该是:主进程、渲染进程、以及项目依赖的外部进程(Python 后端、aria2 等)都就绪,核心功能可交互。

3.4 二次开发前的架构检查清单

动手改代码之前,花十分钟确认这几件事,比改到一半发现方向错了要划算得多。

先读 src/main/ 或主进程入口文件,看 webPreferences 的配置。 contextIsolation 是否为 true、sandbox 是否开启、nodeIntegration 是否为 false,这三项决定了这个项目的安全基线。drawio-desktop 的 electron-preload.js 用 contextBridge 暴露 IPC 桥接,是薄壳项目的标准写法。VS Code 的主进程组织则复杂得多,直接改它的窗口逻辑成本很高。

看 preload 暴露了什么,而不是看它没暴露什么。 一个设计良好的 Electron 项目,preload 的 contextBridge.exposeInMainWorld 调用列表就是渲染进程能访问的全部主进程能力边界。你想加功能,应该在这个列表上扩展,并在对应的 ipcMain.handle 里做参数校验,而不是把 nodeIntegration 打开。

看打包配置和签名配置是否与业务代码分离。 drawio-desktop 的 electron-builder-*.json 和 build/ 目录里的签名脚本是独立的,这意味着壳层配置和业务代码的耦合度较低。如果一个项目的签名逻辑硬编码在主进程或业务代码里,二次开发后重新签名的成本会更高。

最后才看业务代码。 对于薄壳项目(drawio-desktop、lx-music),业务代码的参考价值较高;对于重型架构项目(VS Code、AFFiNE),业务代码的可移植性很低,读架构决策比读实现细节更有用。

四、Electron 应用和纯 Vue 项目(如若依)的本质区别

很多人会问:若依(RuoYi)拿下来就能加业务模块,为什么一个开源的 Electron 桌面应用不能同样“拿来就改”?答案不在开源协议里。Electron 框架本身是 MIT,MarkText 也是 MIT,法律上你完全可以 fork 和商用。真正的分水岭在工程结构,不在许可证。

4.1 若依是“脚手架”,Electron 应用是“加固过的产品”

若依交付给你的是源代码 + 清晰的前后端分层:Controller 收请求,Service 写业务,Mapper 碰数据库。你改一个业务规则,改 Service 层的一个方法,重启后端,生效。它的设计意图就是“让你填业务”。

一个成熟的 Electron 应用交付的是一个已经完成安全加固和分发封装的运行时产品。现代 Electron 默认启用 contextIsolation,sandbox 开启后预加载脚本只能使用 Node.js 的 polyfill 子集,不能直接 require('fs')、不能 require('child_process')。你想加一个“读取本地文件”的功能,不是写一行 fs.readFile 就结束;你需要重新设计 preload 的暴露面、在 IPC 通道上加权限校验、评估这个新接口是否给了渲染进程不该有的能力。改业务之前,先要穿过安全边界。

4.2 交付物的形态不同

若依的终端交付物是源码仓库,部署到自己的服务器。Electron 应用的终端交付物是代码签名后的安装包,可能带自动更新。代码签名证书、各平台打包差异、更新服务器的搭建,这些工程链路不随开源代码一起给你。你可以 fork 一个 Electron 应用的全部源码,但仍然需要从零建立自己的分发流水线。开源代码不包含分发证书和更新服务器,这部分成本必须单独计算。

4.3 框架无关,但“桌面能力”深度耦合

Vue 组件本身可以复用。把 MarkText 的某个 Vue 组件拿到自己的项目里,大概率能跑。但 Electron 的桌面特有逻辑——窗口管理、菜单、托盘、文件系统访问、自动更新——是和主进程、preload、IPC 通道绑在一起的。你不能像剥一个 API 那样把这些能力“干净地拿走”,只能在自己的应用里重新实现一套安全边界,再把业务组件搬进去。

一句话:若依的开源是为了让你“填业务”;Electron 应用的开源,更多是为了透明、审计和社区协作,而不是提供一个“替换外壳就能变成你的产品”的底座。

在这里插入图片描述

图4 若依 vs Electron 应用的结构对比图

五、构建工具链:读这些项目时会反复遇到的名字

TOP10 里的项目虽然渲染层框架不同,但构建链路上有几个工具反复出现,值得单独拎出来对照。

工具定位在榜单中的出现方式
electron-viteVite 驱动的 Electron 开发/构建方案MarkText、VoiceStudio 使用
Electron ForgeElectron 官方打包分发工具链官方推荐新项目起点
electron-builder社区广泛使用的打包工具MarkText、drawio-desktop、AFFiNE 使用
Playwright端到端测试,支持 ElectronMarkText 用 Playwright 做 E2E

electron-vite 的优势在速度:Vite 原生 ESM,渲染进程 HMR 开箱即用。Electron Forge 的优势在官方背书和完整性:build → package → publish 一条链。实际选型上,Vue/React 新项目用 electron-vite + electron-builder 的组合在国内更常见,热更新和前端框架的配置成本更低;如果团队更看重官方维护和全流程统一,Forge 是更稳的选择。

在这里插入图片描述

图5 工具链对照图

六、技术栈分布与选型判断:Vue 开发者该按什么顺序读

TOP10 的渲染层技术栈并不统一,这恰好说明 Electron 的边界:Electron 只提供桌面运行时,页面层用什么框架是开发者自己的选择。 对国内 Vue 开发者来说,读榜单的顺序不应该从 Star 数第一名开始。

你的目标优先读原因
学 Vue + Electron 标准工程结构MarkText、lx-music-desktopVue 3 + electron-vite + Pinia,可以直接对照
学 Electron 安全壳层配置drawio-desktop薄壳封装,安全选项集中
学主进程模块化组织AFFiNENestJS 分层 + 类型安全 IPC
学工具类应用可扩展设计Tabby插件系统把连接类型抽象成插件
学大型编辑器的进程隔离VS CodeExtension Host、LSP、Monaco 三层解耦
学多端共享逻辑JoplinReact Native 与 Electron 共享数据模型、同步和加密层

Vue 开发者最值得先读的是 MarkText,其次 lx-music-desktop。 不是因为它们 Star 数最高,而是技术栈和国内 Vue 团队的重合度最高,而且两者的本地运行门槛在 TOP10 里属于中等偏低,适合作为“第一个成功跑起来的 Electron 开源项目”。

不要按 Star 数决定阅读顺序,按“你的技术栈和项目重量级”决定。 一个三五个窗口的工具类项目,读 VS Code 的架构会得到一堆用不上的抽象;反过来,一个主进程逻辑复杂的产品,只读薄壳项目会漏掉进程组织和 IPC 类型安全的问题。

七、二次开发可行性分级:哪些能改,哪些只能读

把“能不能二次开发”简单回答成“能”或“不能”没有意义。更实用的判断是按改动层次分级:改壳层、改界面、改业务逻辑、改核心引擎,成本完全不是一个量级。

项目改壳层改界面改业务逻辑改核心引擎综合判断
drawio-desktop高中中低最适合学壳层封装
MarkText高高中高中Vue 团队二次开发首选参考
lx-music-desktop高高中低入门级 Vue + Electron 参考
Tabby中中中中插件边界清晰,Angular 有门槛
Motrix中中中中外部引擎现成,界面可改
AFFiNE低中低低读主进程组织,不建议整体 fork
Joplin低中低低同步和加密耦合紧
VS Code低低低低读架构决策,不适合搬业务
Atom低低低低已归档,只读设计理念
VoiceStudio中中低低价值在 Python 推理管线

薄壳项目的壳层可以直接参考,重型架构项目的业务层不要轻易搬。 还有一个常被忽略的判断维度:项目是否把 Web 层和桌面层分开。 AFFiNE 和 Joplin 都属于“逻辑层与平台壳层分离”的架构,二次开发更现实的路径是复用 Web 层或逻辑层,重写桌面壳,而不是在原有 Electron 工程里硬改。

在这里插入图片描述

图6 二次开发可行性分级图

八、注意事项:读源码和二次开发时真正会踩的坑

Star 数不等于“直接 fork 就能用”。 一个 60K Star 的项目,Star 数反映的是产品影响力和社区认可,不是代码的可移植性。动手之前,先看它的入口文件和主进程组织方式,判断它是“薄壳封装”还是“重型架构”。

Electron 版本差异会直接改变安全行为。 从 Electron 12 开始 contextIsolation 默认开启,从 20 开始 preload 默认运行在 sandbox 中。你读一个 2022 年的教程,里面可能还在演示 nodeIntegration: true,这在当前版本的安全实践里是反向操作。对照项目时,先确认它的 Electron 版本和 webPreferences 配置。

nodeIntegration: true 会关掉沙箱。 这是新手二次开发时最常见的“偷懒路径”。功能确实能跑,但那个窗口就变成了一个没有安全边界的浏览器标签页,一旦渲染层有 XSS,攻击者就拿到了完整的 Node.js 权限。正确的路径是扩展 preload 的 contextBridge 暴露面 + 在 IPC handler 里做参数校验,而不是拆掉隔离。

原生模块编译失败,先查环境,不要反复重装。 Windows 上看到 node-gyp 或 MSB 报错,第一反应应该是检查 Visual Studio Build Tools 和 Python 版本,而不是删 node_modules 重来。MarkText 对 Build Tools 的版本和组件有明确要求,VS Code 也有自己的工具链前提。

子模块漏拉是“构建到一半才报错”的典型原因。 Tabby 和 drawio-desktop 都需要 --recursive 克隆。如果你已经普通克隆了,用 git submodule update --recursive --init 补救,而不是重新 clone 整个仓库。

“能启动窗口”不是成功标准。 依赖外部后端的项目(VoiceStudio、Motrix),窗口起来但后端没就绪,功能仍然是空的。判断标准应该是核心功能可交互。

“开源”不包含分发证书和更新服务器。 你可以 fork MarkText 的全部代码,但 macOS 的代码签名证书、Windows 的 EV 证书、自动更新服务器的密钥,都不在仓库里。法律上可以 fork,工程上要重建分发链路。

九、本文总结

按 Star 数筛选 Electron 桌面应用,榜单头部呈现的是一个分化的图景,而不是一个统一的“最佳实践集合”。

VS Code 证明的是“Electron 可以在顶层工程投入足够时承载复杂产品”,但它的性能来自 Piece Tree、V8 快照和进程隔离,不是 Electron 本身。Tabby、AFFiNE、MarkText 代表三种不同的架构取向:Tabby 把可扩展性做进插件系统,AFFiNE 用 NestJS 和类型安全 IPC 管理主进程复杂度,MarkText 展示了一个标准 Vue 3 + electron-vite + Pinia 的 Electron 工程长什么样。drawio-desktop 是“薄壳封装”的参考模板,适合把自己的 Web 项目桌面化时读它的安全配置。

什么场景该读这些项目: 想学 Electron 安全配置,读 drawio-desktop 的壳层;想学 Vue + Electron 的标准工程结构,读 MarkText 的目录和构建配置;想学主进程的模块化组织,读 AFFiNE 的 NestJS 分层;想学工具类应用的可扩展设计,读 Tabby 的插件系统。

什么场景不该直接 fork: 如果你的目标是“拿一个开源桌面应用改改就变成自己的产品”,优先考虑 drawio-desktop 这类薄壳项目,或者在自己的 Web 项目上重新搭 Electron 壳。VS Code、AFFiNE 这类重型架构的项目,读架构决策的价值远大于搬代码。Electron 的安全边界和分发链路需要自己重建,这部分不会随 Star 数一起移交。

对 Vue 开发者来说,最实际的路径是:先用 electron-vite 起一个 Vue 3 + Electron 的空项目,再对照 MarkText 的目录结构和 preload 写法读一遍,最后按自己的业务需要设计 IPC 白名单。 如果想先跑一个现成的项目建立体感,lx-music-desktop 的本地运行成本最低。这比一上来就 fork 一个 60K Star 的重型项目更省时间,也更不容易把安全边界拆坏。

十、更多操作

本文属于 Electron + Vue 桌面应用 专栏的生态调研篇。专栏持续更新 Vue2/Vue3 与 Electron 的整合实战,涵盖环境搭建、主进程与渲染进程通信、预加载脚本的安全设计、electron-vite / electron-builder 打包发布、自动更新和性能调优。

👉 Electron + Vue 桌面应用专栏

本专栏聚焦 Electron + Vue 桌面应用实战,系统讲解 Vue2、Vue3 与 Electron 的整合实践,涵盖环境搭建、主进程与渲染进程通信、预加载脚本、窗口菜单、打包发布、自动更新及安全实践,帮助前端开发者从零构建跨平台桌面应用。

以及

👉 Vue Develop 实战专栏

想继续深挖的读者,可以从这几个方向入手:

  • 官方文档:Electron 的 Context Isolation 和 Sandbox 文档是理解安全边界的第一手资料,比任何二手教程都准确。
  • electron-vite 模板:用 electron-vite 起一个 Vue 3 项目,对着 MarkText 的目录结构读一遍,比只看文章理解得更快。
  • 读源码的顺序:先读 package.json 的 engines 和 packageManager,再读主进程入口和 webPreferences,最后读 preload 的 contextBridge 暴露面。这三步能快速判断一个项目的安全模型和本地运行前提。
  • 依赖安装的通用排查顺序:Node 版本 → 包管理器类型 → Electron 镜像 → 原生模块的 Build Tools / Python → 子模块是否完整。按这个顺序查,大部分“装不上”的问题都能定位。
  • 下一步可以深挖的点:preload 的最小暴露面设计、IPC 参数校验的通用封装、electron-builder 的多平台打包配置、自动更新服务器的搭建方式。

如果本文对你有帮助,欢迎点赞、收藏、评论。你在本地跑这些 Electron 项目时卡在哪一步,或者二次开发时遇到过“安全边界挡住业务”的情况,欢迎留言交流具体场景。





在这里插入图片描述

转载自 CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/weixin_65793170/article/details/169948398

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--