差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 | |||
| 使用ipc进行通讯 [2026/11/17 08:16] – 补充 Electron IPC 进程间通讯完整知识点 张叶安 | 使用ipc进行通讯 [2026/11/17 08:16] (当前版本) – 添加 IPC 知识点速记导图 张叶安 | ||
|---|---|---|---|
| 行 130: | 行 130: | ||
| ===== 七、速记导图 ===== | ===== 七、速记导图 ===== | ||
| + | |||
| + | ```mdk height=520 color=# | ||
| + | # Electron IPC 进程间通讯 | ||
| + | |||
| + | ## 进程模型 | ||
| + | ### 主进程 main | ||
| + | - 全局唯一,Node.js 环境 | ||
| + | - 窗口 / 菜单 / 对话框 / 文件系统 | ||
| + | ### 渲染进程 renderer | ||
| + | - 每窗口一个,Chromium | ||
| + | - 默认没有 Node 能力 | ||
| + | ### 预加载 preload | ||
| + | - 隔离世界 | ||
| + | - 唯一桥梁 | ||
| + | |||
| + | ## 四条通道 | ||
| + | ### 渲染 → 主 send / on | ||
| + | - 单向通知 | ||
| + | - 拿不到返回值 | ||
| + | ### 渲染 → 主 invoke / handle(首选) | ||
| + | - 返回 Promise | ||
| + | - 支持 async/await | ||
| + | - 错误自动 reject | ||
| + | ### 主 → 渲染 webContents.send | ||
| + | - 先注册 ipcRenderer.on | ||
| + | - 小心消息被错过 | ||
| + | ### 同步 sendSync | ||
| + | - 阻塞渲染进程 | ||
| + | - 有死锁风险,避免 | ||
| + | ### 渲染 ↔ 渲染 | ||
| + | - 经主进程转发 | ||
| + | - MessageChannelMain / MessagePort | ||
| + | |||
| + | ## 安全 | ||
| + | ### contextIsolation 默认 true | ||
| + | ### nodeIntegration 默认 false | ||
| + | ### 不暴露整个 ipcRenderer | ||
| + | ### 只暴露动词级窄接口 | ||
| + | ### channel 名写死在 preload | ||
| + | ### 校验 event.senderFrame.url | ||
| + | ### 参数自己做白名单 | ||
| + | |||
| + | ## 传值规则 | ||
| + | ### 结构化克隆,不是 JSON | ||
| + | - Date / Map / Set / ArrayBuffer | ||
| + | ### 不能传函数、DOM、Symbol | ||
| + | ### 类实例会丢原型方法 | ||
| + | ### Error 只保留 message | ||
| + | - 建议返回 { ok, code } | ||
| + | ### 大数据要分批或走文件 | ||
| + | |||
| + | ## 常见坑 | ||
| + | ### No handler registered | ||
| + | ### handle 重复注册会抛错 | ||
| + | ### Object has been destroyed | ||
| + | ### 监听器泄漏 MaxListenersExceeded | ||
| + | ### dialog 父窗口 fromWebContents | ||
| + | ### sandbox 下 preload 受限 | ||
| + | ### channel 命名 模块: | ||
| + | |||
| + | ## 一句话 | ||
| + | ### invoke/ | ||
| + | ### webContents.send 做推送 | ||
| + | ### 最小暴露 | ||
| + | ### 永不信任渲染进程参数 | ||
| + | ``` | ||