主进程和渲染进程
一句话:主进程是应用的大脑,渲染进程是每个窗口的脸;两者内存隔离、不能直接调用函数,只能通过 IPC 传消息。
| 对比项 | 主进程 main | 渲染进程 renderer |
|---|---|---|
| 运行环境 | Node.js | Chromium(本质是网页) |
| 数量 | 全局唯一 | 每个窗口一个 |
| 职责 | 窗口、菜单、托盘、生命周期、文件与系统 API | 只负责绘制界面 |
| Node 能力 | 原生可用 | 默认不可用 |
| 崩溃影响 | 整个应用退出 | 只影响该窗口 |
一、两者的关系
- 完全隔离:渲染进程拿不到主进程的变量、函数、对象,反过来的调用也做不到。
- 主进程是唯一决策中心:窗口的创建、关闭、系统能力统一由它处理。
- 渲染进程是可丢弃的:窗口关掉即销毁,重新打开是新实例,状态需重新拉取。
- 通道只有一条:两者之间的一切交互都是 IPC 消息,没有共享内存式的捷径。
二、桥梁:preload
preload 在渲染进程内、页面脚本执行前运行,是唯一同时能看到 Node 与页面的地方。
// preload.js const { contextBridge, ipcRenderer } = require('electron') contextBridge.exposeInMainWorld('api', { readConfig: () => ipcRenderer.invoke('config:read'), onProgress: (cb) => ipcRenderer.on('progress', (_e, v) => cb(v)), })
页面侧直接调用 window.api.readConfig()。不要整体暴露 ipcRenderer、require 或万能通道。
三、四种 IPC 模式
| 模式 | 方向 | 适用场景 |
|---|---|---|
invoke / handle | 渲染 → 主,返回 Promise | 请求-响应,首选 |
send / on | 渲染 → 主,单向 | 通知类,不关心结果 |
webContents.send | 主 → 渲染 | 推送进度、状态变化 |
MessageChannel | 双向长通道 | 高频或流式数据 |
// 渲染进程 const data = await window.api.readConfig() // 主进程 ipcMain.handle('config:read', async () => fs.readFile(configPath, 'utf-8'))
四、必须记住的限制
- 传参只能是可序列化的结构化克隆数据;函数、类实例、Proxy、DOM 节点会抛
An object could not be cloned。 - IPC 全异步,不要指望同步拿回结果。
- 主进程侧必须校验参数与发送方(
event.senderFrame),默认渲染进程传来的内容不可信。 - 渲染进程可能被注入不可信内容,权限越小越安全:
contextIsolation: true、nodeIntegration: false、sandbox: true。 - 主进程里做同步 IO 或重计算,会卡住所有窗口的 IPC 响应,应改为异步或交给工作线程。
五、常见坑
- 白屏:
loadFile路径错误,或打包后 preload 相对路径失效。 window.api是 undefined:preload 未加载、路径不对,或写法与contextIsolation配置不匹配。- 关窗后回调报错:窗口已销毁仍在
webContents.send,发消息前先判isDestroyed()。 - 开发能跑、打包失败:主进程与渲染进程的路径基准不同,改用
app.getAppPath()/process.resourcesPath。 - 内存只增不减:窗口销毁不彻底、监听器未移除。