====== 主进程和渲染进程 ======
[[electron]]
一句话:**主进程是应用的大脑,渲染进程是每个窗口的脸;两者内存隔离、不能直接调用函数,只能通过 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''。
* **内存只增不减**:窗口销毁不彻底、监听器未移除。