主进程和渲染进程

主进程和渲染进程

electron

一句话:主进程是应用的大脑,渲染进程是每个窗口的脸;两者内存隔离、不能直接调用函数,只能通过 IPC 传消息。

对比项 主进程 main 渲染进程 renderer
运行环境 Node.js Chromium(本质是网页)
数量 全局唯一 每个窗口一个
职责 窗口、菜单、托盘、生命周期、文件与系统 API 只负责绘制界面
Node 能力 原生可用 默认不可用
崩溃影响 整个应用退出 只影响该窗口
  • 完全隔离:渲染进程拿不到主进程的变量、函数、对象,反过来的调用也做不到。
  • 主进程是唯一决策中心:窗口的创建、关闭、系统能力统一由它处理。
  • 渲染进程是可丢弃的:窗口关掉即销毁,重新打开是新实例,状态需重新拉取。
  • 通道只有一条:两者之间的一切交互都是 IPC 消息,没有共享内存式的捷径。

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'))
  • 传参只能是可序列化的结构化克隆数据;函数、类实例、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
  • 由 张叶安