本文说明 Electron 的进程模型与应用骨架。进程间通信与预加载脚本见 进程间通信与预加载,本地能力集成见 本地能力集成,安全配置见 Electron 安全加固,打包与发布见 打包签名与发布,工程实践与排查见 工程实践与排查,渲染流程与脚本加载方式见 浏览器渲染与 Web 安全,前端构建与产物组织见 前端工程化,与框架集成见 Vue2 工程实践。
一、起源
1.1 用网页技术做桌面应用的三类问题
| 问题 | 说明 |
|---|---|
| 能力边界 | 网页运行环境无法直接访问文件系统与系统资源 |
| 界面与系统一致 | 需要与操作系统的窗口、菜单、托盘、通知体系协同 |
| 分发与更新 | 需要安装包、签名与自动更新,而不是部署到服务器 |
Electron 的做法是把浏览器内核与运行时打包进应用,使网页技术获得系统访问能力,同时保留网页的渲染能力与生态。
1.2 三进程的职责划分
| 角色 | 运行环境 | 职责 | 不具备 |
|---|---|---|---|
| 主进程 | 完整的运行时与系统接口 | 应用生命周期、窗口创建、系统能力调用、数据与状态中枢 | 界面渲染 |
| 渲染进程 | 浏览器内核 | 界面渲染与交互逻辑,可运行前端框架 | 默认不能直接访问系统接口 |
| 预加载脚本 | 渲染进程内、页面脚本之前 | 在两个世界之间建立受控通道 | 不承担业务逻辑 |
这一划分的意义是把"可信的系统操作"与"可能被注入内容的界面逻辑"隔离,因此边界必须由通信层显式约束,而不是靠约定。
1.3 取舍
| 选择 | 获得 | 付出 |
|---|---|---|
| 使用多进程与隔离 | 界面异常不导致整体退出,安全边界清晰 | 通信与状态同步带来复杂度,调试需要跨进程视角 |
| 关闭隔离让渲染进程直连系统接口 | 写起来直接 | 一旦加载了不可信内容即可执行任意系统操作,风险不可接受 |
二、原理
2.1 运行结构
应用启动后的结构如下:
可执行程序(内置内核与运行时)
├── 主进程(唯一)── 创建与管理系统资源
│ └── 与各渲染进程通过消息通道通信
├── 渲染进程 A(窗口一)
│ ├── 预加载脚本(隔离环境中执行)
│ └── 页面脚本(前端框架)
├── 渲染进程 B(窗口二)
└── 辅助进程(网络、图形、工具进程等,由内核管理)
三点结论:
- 主进程是唯一的,因此它是唯一的可信状态中枢;渲染进程之间不应直接通信,而应经由主进程中转。
- 每个窗口对应一个渲染进程,关闭窗口即释放该进程与其内存。
- 内核还会派生若干辅助进程(网络与图形与音视频),这些不由应用代码直接管理。
2.2 应用生命周期
| 阶段 | 关键事件 | 适用 |
|---|---|---|
| 启动前 | 应用就绪之前 | 只能做与界面无关的初始化 |
| 就绪 | 可以创建窗口 | 创建主窗口、注册全局快捷键与协议处理 |
| 窗口全部关闭 | 需要判断是否退出 | 各平台行为不同,需按平台分支处理 |
| 激活 | 点击任务栏或图标重新激活 | 无窗口时重建窗口,多用于关闭窗口不退出应用的平台 |
| 退出前 | 可以阻止退出 | 保存状态、确认未完成的操作 |
| 将要退出 | 清理资源 | 注销全局快捷键、断开监听、刷新日志 |
| 已退出 | 进程结束 | 一般无需处理 |
平台差异集中在"窗口全部关闭"这一环:在某类平台上关闭最后一个窗口通常意味着应用退出,而在另一类平台上应用会继续驻留,需要借助激活事件重建窗口。若不区分平台,会出现"关闭窗口后任务栏图标仍在但点击无反应"的现象。
2.3 单实例与二次唤醒
桌面应用通常只允许一个实例,原因是系统资源(托盘、全局快捷键、文件关联、本地数据文件)无法被多实例安全共享。
处理方式是启动时申请实例锁,未获得锁则立即退出,并在已运行的实例中监听"第二个实例被启动"事件,把参数(如命令行传入的文件路径或自定义协议地址)转交给已有实例处理。二次唤醒的参数传递是实现"双击文件用已有窗口打开"的基础。
2.4 窗口
| 关注点 | 要点 |
|---|---|
| 创建选项 | 尺寸与位置、是否显示边框与标题栏、图标、可否缩放、是否置于最前 |
| 显示时机 | 先创建为隐藏,等界面准备就绪再显示,避免出现空白窗口 |
| 关闭拦截 | 在关闭事件中可阻止默认行为,用于确认未保存内容;注意区分"请求关闭"与"已经关闭" |
| 窗口复用 | 关闭后重新创建与隐藏保留两种策略,前者释放内存,后者恢复更快 |
| 状态保持 | 尺寸与位置需要应用自行持久化,退出前保存并在下次启动时恢复 |
| 多窗口协作 | 以主进程中转消息,不要依赖窗口之间直接互相引用 |
显示时机的处理是体验上的关键细节:默认创建窗口会立即显示,此时界面尚未渲染完成,用户会看到短时间的空白或闪烁。应先隐藏创建,在首帧准备就绪后再显示。
2.5 崩溃与阻塞
| 故障 | 后果 | 处置 |
|---|---|---|
| 渲染进程崩溃 | 单个窗口界面异常,应用其他部分不受影响 | 监听渲染进程异常事件并给出恢复入口,必要时重载窗口 |
| 主进程崩溃 | 整个应用退出 | 捕获未处理异常并记录,避免静默退出 |
| 辅助进程异常 | 网络或图形异常,界面可能空白 | 监听子进程异常事件,识别是否为图形加速问题 |
| 主进程被阻塞 | 所有窗口失去响应,系统能力调用排队 | 排查启动阶段的同步操作与长任务 |
主进程被阻塞是最容易被误判的问题:界面看起来像是"渲染卡住",但根因在主进程执行了同步的重操作(同步读写大文件、同步遍历目录、密集计算)。
2.6 长任务的三种卸载方式
| 方式 | 适用 | 特点 |
|---|---|---|
| 工具进程 | 与主进程同运行时,需要访问系统接口 | 独立进程、崩溃不牵连主进程,适合中等规模任务 |
| 工作线程 | 纯计算、不需要界面与部分系统接口 | 线程内共享内存更直接,适合密集计算 |
| 子进程 | 调用外部程序或需要完全隔离 | 通用但通信成本较高 |
选择依据是任务是否需要系统接口与是否可能长时间占用:涉及大量系统调用与文件操作的任务适合独立进程,纯计算适合线程。
2.7 加载来源的环境差异
| 环境 | 加载方式 | 带来的差异 |
|---|---|---|
| 开发 | 加载本地开发服务器地址 | 支持热更新,但需要处理服务未启动的情况 |
| 生产 | 加载本地文件 | 使用文件协议,相对路径与绝对路径的基准不同,路由需要相应配置 |
由此产生两类典型问题:生产环境下用绝对路径引用的资源会失败(文件协议下根目录不是站点根目录);使用历史模式路由的单页面应用在文件协议下刷新会找不到路径。解决方式是在构建时把公共路径改为相对路径,并改为使用哈希模式或由应用自身控制路由。
三、实现
3.1 应用入口骨架
// main.js:主进程入口
const { app, BrowserWindow, globalShortcut, dialog } = require('electron');
const path = require('node:path');
const isDev = !app.isPackaged;
let mainWindow = null;
// 单实例:未获得锁的实例立即退出,把参数交给已有实例
const gotLock = app.requestSingleInstanceLock();
if (!gotLock) {
app.quit();
} else {
app.on('second-instance', (_event, argv) => {
// 二次唤醒:把命令行参数转交已有实例处理(如自定义协议或文件路径)
handleExternalArgs(argv);
if (mainWindow) {
if (mainWindow.isMinimized()) mainWindow.restore();
mainWindow.show();
mainWindow.focus();
}
});
}
function createMainWindow() {
const win = new BrowserWindow({
width: 1280,
height: 800,
minWidth: 960,
minHeight: 640,
show: false, // 先隐藏,避免空白窗口闪烁
autoHideMenuBar: process.platform !== 'darwin',
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
contextIsolation: true, // 隔离页面脚本与预加载环境
sandbox: true, // 渲染进程沙箱
nodeIntegration: false, // 禁止页面直接使用运行时接口
spellcheck: false,
},
});
// 首帧准备好后再显示
win.once('ready-to-show', () => win.show());
if (isDev) {
win.loadURL('http://localhost:5173');
win.webContents.openDevTools({ mode: 'detach' });
} else {
win.loadFile(path.join(__dirname, '../renderer/index.html'));
}
// 关闭拦截:有未保存内容时先确认
win.on('close', (event) => {
if (hasUnsavedChanges()) {
const choice = dialog.showMessageBoxSync(win, {
type: 'warning',
buttons: ['放弃更改并退出', '返回'],
defaultId: 1,
cancelId: 1,
message: '存在未保存的内容,确定退出吗?',
});
if (choice === 1) event.preventDefault();
}
});
win.on('closed', () => { mainWindow = null; });
return win;
}
app.whenReady().then(() => {
mainWindow = createMainWindow();
// 全局快捷键需要在就绪之后注册
globalShortcut.register('CommandOrControl+Shift+K', () => {
mainWindow?.webContents.send('shortcut:open-search');
});
// 关闭全部窗口后按平台决定是否退出
app.on('activate', () => {
if (BrowserWindow.getAllWindows().length === 0) {
mainWindow = createMainWindow();
}
});
});
app.on('window-all-closed', () => {
// 在保持驻留的平台上不退出,其余平台退出
if (process.platform !== 'darwin') app.quit();
});
app.on('will-quit', () => {
// 注销全局快捷键,避免残留
globalShortcut.unregisterAll();
});
// 主进程未处理异常:记录后按需提示,避免静默退出
process.on('uncaughtException', (err) => {
console.error('[main] uncaughtException', err);
});
process.on('unhandledRejection', (reason) => {
console.error('[main] unhandledRejection', reason);
});
function handleExternalArgs() { /* 解析并分发外部参数 */ }
function hasUnsavedChanges() { return false; }
3.2 窗口管理
// windows.js:集中管理窗口,避免散落创建
const { BrowserWindow } = require('electron');
const path = require('node:path');
const windows = new Map(); // key -> BrowserWindow
function getOrCreate(key, options = {}) {
const existing = windows.get(key);
if (existing && !existing.isDestroyed()) {
existing.focus();
return existing;
}
const win = new BrowserWindow({
show: false,
...options,
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
contextIsolation: true,
sandbox: true,
nodeIntegration: false,
},
});
win.once('ready-to-show', () => win.show());
win.on('closed', () => windows.delete(key));
windows.set(key, win);
return win;
}
function broadcast(channel, payload) {
// 由主进程统一广播,避免窗口之间互相引用
for (const win of windows.values()) {
if (!win.isDestroyed()) win.webContents.send(channel, payload);
}
}
function closeAll() {
for (const win of windows.values()) win.close();
}
module.exports = { getOrCreate, broadcast, closeAll };
3.3 长任务卸载
// 使用工具进程执行涉及系统接口的耗时任务(独立进程,不阻塞主进程)
const { utilityProcess } = require('electron');
const path = require('node:path');
let worker = null;
function startScan(targetDir) {
worker = utilityProcess.fork(path.join(__dirname, 'scan-worker.js'));
worker.postMessage({ type: 'scan', targetDir });
worker.on('message', (msg) => {
// 进度回传:转发给界面
const win = require('./windows').getOrCreate('main');
win.webContents.send('scan:progress', msg);
});
worker.on('exit', (code) => {
console.log('[main] scan worker exit', code);
worker = null;
});
}
// scan-worker.js:在独立进程中执行,避免阻塞主进程
const { parentPort } = require('node:worker_threads');
const fs = require('node:fs/promises');
const path = require('node:path');
parentPort.on('message', async ({ type, targetDir }) => {
if (type !== 'scan') return;
let count = 0;
const entries = await fs.readdir(targetDir, { withFileTypes: true });
for (const entry of entries) {
parentPort.postMessage({ name: entry.name, isDir: entry.isDirectory() });
count += 1;
// 分批回传,避免一次性发送大量消息占用通道
if (count % 200 === 0) await new Promise((r) => setImmediate(r));
}
parentPort.postMessage({ done: true, total: count });
});
3.4 常见问题对照
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 启动时出现空白窗口后闪烁 | 窗口先显示后渲染 | 隐藏创建并在首帧就绪后显示 |
| 关闭窗口后图标仍在但点击无反应 | 未处理重新激活事件 | 在激活事件中重建窗口 |
| 启动第二个实例导致数据异常 | 未做单实例控制 | 申请实例锁并把参数转交已有实例 |
| 双击文件未在已有窗口打开 | 未处理二次唤醒参数 | 在二次唤醒事件中解析并分发参数 |
| 所有窗口同时失去响应 | 主进程执行了同步重操作 | 把耗时任务卸载到独立进程或线程 |
| 界面卡顿但界面代码无问题 | 主进程被阻塞导致系统调用排队 | 查看主进程执行栈,排查启动与定时任务 |
| 某个窗口崩溃后应用退出 | 崩溃被当作未处理异常终止应用 | 区分渲染与主进程异常并分别处理 |
| 生产环境资源加载失败 | 使用文件协议但路径按站点根目录书写 | 构建时改为相对路径 |
| 生产环境刷新后页面找不到 | 历史模式路由在文件协议下无服务端回退 | 改为哈希模式或由应用控制路由 |
| 开发环境正常而打包后白屏 | 加载来源由服务地址变为本地文件 | 区分环境加载方式并核对路径与协议 |
| 全局快捷键在重启后失效或与系统冲突 | 未在退出时注销或被其他程序占用 | 退出时统一注销,注册失败时提示用户 |
| 主进程异常后应用静默退出 | 未捕获主进程的未处理异常 | 注册未处理异常与未处理拒绝并记录日志 |
四、总结
- Electron 把浏览器内核与运行时打包进应用,使网页技术获得系统访问能力,代价是引入三进程职责划分与跨进程通信。
- 主进程是唯一可信状态中枢,渲染进程负责界面,预加载脚本在两世界之间建立受控通道,边界必须由通信层显式约束。
- 应用生命周期的平台差异集中在"窗口全部关闭"环节,需按平台决定退出或驻留,并在激活事件中重建窗口。
- 桌面应用应做单实例控制,通过实例锁与二次唤醒事件把外部参数转交已有实例处理。
- 窗口应先隐藏创建、在首帧就绪后显示,以避免空白闪烁;状态需要应用自行持久化。
- 渲染进程崩溃只影响单个窗口,主进程崩溃导致应用退出,两类异常需要分别监听与处理。
- 主进程被同步重操作阻塞会表现为"所有窗口卡住",是最容易被误判为界面问题的一类故障。
- 长任务按是否需要系统接口选择工具进程、工作线程或子进程,避免占用主进程。
- 开发与生产的加载来源不同,文件协议下的路径基准与站点根目录不同,构建与路由都需要相应处理。
- 三类资源需要显式清理:全局快捷键、跨进程监听与窗口引用,否则会造成残留与内存增长。