Electron 是一个用 HTML / CSS / JavaScript 编写跨平台桌面应用的开源框架,由 Chromium 渲染引擎与 Node.js 运行时组合而成,最初由 GitHub 团队发起,现由 OpenJS Foundation 托管维护。
一句话理解:打包后的 Electron 应用,就是一个内置了 Chromium 与 Node 的可执行文件,它加载你的网页作为界面,同时把文件系统、菜单、托盘、通知等系统能力通过进程间通信交给界面使用。
典型应用:VS Code、Slack、Discord、Figma 桌面版、Obsidian、Notion、1Password 8。
这是理解 Electron 的第一道关,也是最容易出错的地方。
| 角色 | 运行环境 | 数量 | 职责 |
|---|---|---|---|
| 主进程 main | Node.js 环境 | 全局唯一 | 创建与管理窗口、菜单、托盘,访问文件系统、调用系统 API、管理应用生命周期 |
| 渲染进程 renderer | Chromium 多进程 | 每个窗口一个 | 只负责绘制界面,本质是网页;默认无法直接使用 Node |
| 预加载脚本 preload | 渲染进程内、页面加载前执行 | 每个窗口一个 | 通过 contextBridge 把白名单 API 暴露给页面,充当中介 |
要点:
require、fs 等并非默认可用,需显式开放或经 preload 桥接。ipcMain.handle / ipcRenderer.invoke:Promise 风格的请求-响应,推为首选ipcRenderer.send / ipcMain.on:单向消息webContents.send:主进程主动向指定窗口推送MessageChannel / MessagePort:建立长期双向通道Electron 的安全问题几乎都源于「给渲染进程开了太多权限」,务必掌握:
contextIsolation: true(默认开启)、nodeIntegration: false(默认关闭)、sandbox: trueipcRenderer、require 或一个万能通信通道event.senderFrame)Content-Security-Policy),避免加载不可信的远程内容remote 模块已被废弃,不应用于新项目shell.openExternal 前校验 URL 协议BrowserWindow:尺寸与位置、frame、titleBarStyle、透明窗口、无边框窗口screen 模块)WebContentsView(新版推荐,用于在窗口内嵌入多个网页视图)与旧 BrowserView、webview 标签的取舍show: false 配合 ready-to-show 避免白屏闪烁app.whenReady() 之后再创建窗口window-all-closed:Windows / Linux 关窗即退出,macOS 通常保留activate:点击 Dock 时若无窗口则重建before-quit / will-quit:清理资源、取消未完成的写入app.requestSingleInstanceLock():单实例限制,配合 second-instance 聚焦已有窗口Menu、上下文菜单、托盘 TrayNotification、任务栏进度与角标dialog 文件选择 / 保存、文件拖拽、clipboardglobalShortcut 全局快捷键protocol(如 myapp 这类自定义 scheme)、开机自启、跟随系统主题fs、path、child_process、oselectron-rebuild、ABI 版本对齐electron-store(JSON 配置)、better-sqlite3(关系型)、IndexedDB(前端侧)safeStorage 加密敏感凭据,避免明文落盘electron-vite / Vite + TypeScript、electron-forge、electron-builderasar 归档、extraResources、资源路径(app.getAppPath()、process.resourcesPath)autoUpdater / electron-updater、更新服务器、差量包、灰度发布crashReporter、日志 electron-log–inspect 接入 Chrome DevToolselectron-devtools-installer 装框架插件loadFile 路径错误、CSP 拦截、preload 路径在打包后失效dirname 路径基准的语义在 asar 内会变化,应改用 app.getAppPath() 或 process.resourcesPathwindow-all-closed 中区分平台electron-rebuild)app.isPackaged 分支