一句话:主进程是应用的大脑,渲染进程是每个窗口的脸;两者内存隔离、不能直接调用函数,只能通过 IPC 传消息。
| 对比项 | 主进程 main | 渲染进程 renderer |
|---|---|---|
| 运行环境 | Node.js | Chromium(本质是网页) |
| 数量 | 全局唯一 | 每个窗口一个 |
| 职责 | 窗口、菜单、托盘、生命周期、文件与系统 API | 只负责绘制界面 |
| Node 能力 | 原生可用 | 默认不可用 |
| 崩溃影响 | 整个应用退出 | 只影响该窗口 |
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 或万能通道。
| 模式 | 方向 | 适用场景 |
|---|---|---|
invoke / handle | 渲染 → 主,返回 Promise | 请求-响应,首选 |
send / on | 渲染 → 主,单向 | 通知类,不关心结果 |
webContents.send | 主 → 渲染 | 推送进度、状态变化 |
MessageChannel | 双向长通道 | 高频或流式数据 |
// 渲染进程 const data = await window.api.readConfig() // 主进程 ipcMain.handle('config:read', async () => fs.readFile(configPath, 'utf-8'))
An object could not be cloned。event.senderFrame),默认渲染进程传来的内容不可信。contextIsolation: true、nodeIntegration: false、sandbox: true。loadFile 路径错误,或打包后 preload 相对路径失效。window.api 是 undefined:preload 未加载、路径不对,或写法与 contextIsolation 配置不匹配。webContents.send,发消息前先判 isDestroyed()。app.getAppPath() / process.resourcesPath。