主进程和渲染进程

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

主进程和渲染进程 [2026/11/16 20:23] – 创建 张叶安主进程和渲染进程 [2026/11/16 20:25] (当前版本) – 补充主进程与渲染进程的关系、IPC、preload 与常见坑 张叶安
行 1: 行 1:
-1+====== 主进程和渲染进程 ====== 
 + 
 +[[electron]] 
 + 
 +一句话:**主进程是应用的大脑,渲染进程是每个窗口的脸;两者内存隔离、不能直接调用函数,只能通过 IPC 传消息。** 
 + 
 +^ 对比项 ^ 主进程 main ^ 渲染进程 renderer ^ 
 +| 运行环境 | Node.js | Chromium(本质是网页) | 
 +| 数量 | 全局唯一 | 每个窗口一个 | 
 +| 职责 | 窗口、菜单、托盘、生命周期、文件与系统 API | 只负责绘制界面 | 
 +| Node 能力 | 原生可用 | 默认不可用 | 
 +| 崩溃影响 | 整个应用退出 | 只影响该窗口 | 
 + 
 +===== 一、两者的关系 ===== 
 + 
 +  * **完全隔离**:渲染进程拿不到主进程的变量、函数、对象,反过来的调用也做不到。 
 +  * **主进程是唯一决策中心**:窗口的创建、关闭、系统能力统一由它处理。 
 +  * **渲染进程是可丢弃的**:窗口关掉即销毁,重新打开是新实例,状态需重新拉取。 
 +  * **通道只有一条**:两者之间的一切交互都是 IPC 消息,没有共享内存式的捷径。 
 + 
 +===== 二、桥梁:preload ===== 
 + 
 +preload 在渲染进程内、页面脚本执行前运行,是唯一同时能看到 Node 与页面的地方。 
 + 
 +<code javascript> 
 +// preload.js 
 +const { contextBridge, ipcRenderer } = require('electron') 
 + 
 +contextBridge.exposeInMainWorld('api', { 
 +  readConfig: () => ipcRenderer.invoke('config:read'), 
 +  onProgress: (cb) => ipcRenderer.on('progress', (_e, v) => cb(v)), 
 +}) 
 +</code> 
 + 
 +页面侧直接调用 ''window.api.readConfig()''。**不要整体暴露 ''ipcRenderer''、''require'' 或万能通道。** 
 + 
 +===== 三、四种 IPC 模式 ===== 
 + 
 +^ 模式 ^ 方向 ^ 适用场景 ^ 
 +| ''invoke'' / ''handle'' | 渲染 → 主,返回 Promise | 请求-响应,**首选** | 
 +| ''send'' / ''on'' | 渲染 → 主,单向 | 通知类,不关心结果 | 
 +| ''webContents.send'' | 主 → 渲染 | 推送进度、状态变化 | 
 +| ''MessageChannel'' | 双向长通道 | 高频或流式数据 | 
 + 
 +<code javascript> 
 +// 渲染进程 
 +const data = await window.api.readConfig() 
 + 
 +// 主进程 
 +ipcMain.handle('config:read', async () => fs.readFile(configPath, 'utf-8')) 
 +</code> 
 + 
 +===== 四、必须记住的限制 ===== 
 + 
 +  * 传参只能是**可序列化**的结构化克隆数据;函数、类实例、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''。 
 +  * **内存只增不减**:窗口销毁不彻底、监听器未移除。 

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 主进程和渲染进程.txt
  • 最后更改: 2026/11/16 20:25
  • 由 张叶安