目录

主进程和渲染进程

electron

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

对比项 主进程 main 渲染进程 renderer
运行环境 Node.js Chromium(本质是网页)
数量 全局唯一 每个窗口一个
职责 窗口、菜单、托盘、生命周期、文件与系统 API 只负责绘制界面
Node 能力 原生可用 默认不可用
崩溃影响 整个应用退出 只影响该窗口

一、两者的关系

二、桥梁: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'))

四、必须记住的限制

五、常见坑