本文说明 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 常见问题对照

现象 常见原因 处置
启动时出现空白窗口后闪烁 窗口先显示后渲染 隐藏创建并在首帧就绪后显示
关闭窗口后图标仍在但点击无反应 未处理重新激活事件 在激活事件中重建窗口
启动第二个实例导致数据异常 未做单实例控制 申请实例锁并把参数转交已有实例
双击文件未在已有窗口打开 未处理二次唤醒参数 在二次唤醒事件中解析并分发参数
所有窗口同时失去响应 主进程执行了同步重操作 把耗时任务卸载到独立进程或线程
界面卡顿但界面代码无问题 主进程被阻塞导致系统调用排队 查看主进程执行栈,排查启动与定时任务
某个窗口崩溃后应用退出 崩溃被当作未处理异常终止应用 区分渲染与主进程异常并分别处理
生产环境资源加载失败 使用文件协议但路径按站点根目录书写 构建时改为相对路径
生产环境刷新后页面找不到 历史模式路由在文件协议下无服务端回退 改为哈希模式或由应用控制路由
开发环境正常而打包后白屏 加载来源由服务地址变为本地文件 区分环境加载方式并核对路径与协议
全局快捷键在重启后失效或与系统冲突 未在退出时注销或被其他程序占用 退出时统一注销,注册失败时提示用户
主进程异常后应用静默退出 未捕获主进程的未处理异常 注册未处理异常与未处理拒绝并记录日志

四、总结

  1. Electron 把浏览器内核与运行时打包进应用,使网页技术获得系统访问能力,代价是引入三进程职责划分与跨进程通信。
  2. 主进程是唯一可信状态中枢,渲染进程负责界面,预加载脚本在两世界之间建立受控通道,边界必须由通信层显式约束。
  3. 应用生命周期的平台差异集中在"窗口全部关闭"环节,需按平台决定退出或驻留,并在激活事件中重建窗口。
  4. 桌面应用应做单实例控制,通过实例锁与二次唤醒事件把外部参数转交已有实例处理。
  5. 窗口应先隐藏创建、在首帧就绪后显示,以避免空白闪烁;状态需要应用自行持久化。
  6. 渲染进程崩溃只影响单个窗口,主进程崩溃导致应用退出,两类异常需要分别监听与处理。
  7. 主进程被同步重操作阻塞会表现为"所有窗口卡住",是最容易被误判为界面问题的一类故障。
  8. 长任务按是否需要系统接口选择工具进程、工作线程或子进程,避免占用主进程。
  9. 开发与生产的加载来源不同,文件协议下的路径基准与站点根目录不同,构建与路由都需要相应处理。
  10. 三类资源需要显式清理:全局快捷键、跨进程监听与窗口引用,否则会造成残留与内存增长。