进程间的 IPC 通信

ipcMain.handle 会在主进程中注册一个命名通道，用于响应来自渲染进程的请求。它接受一个异步处理函数，其返回值会成为渲染进程中 Promise 的解析值，因此非常适合执行读取文件或查询数据库等操作。

ipcRenderer.invoke 会在命名通道上发送消息，并返回一个 Promise；该 Promise 会解析为主进程处理程序的返回值。这样便形成了简洁的异步请求-响应模式，可在预加载脚本和 React 组件中自然地与 async/await 配合使用。

预加载脚本会封装 ipcRenderer.invoke 调用，并通过 contextBridge 暴露它们。例如：api.readFile = (filePath) => ipcRenderer.invoke('read-file', filePath)。渲染进程调用 window.api.readFile(path) 后会得到一个 Promise——整洁且处于沙箱保护之中。

启用 contextIsolation 后，渲染进程无法 require('electron') 或直接导入 ipcRenderer——该模块根本不可用。所有 IPC 通信都必须经过预加载脚本通过 contextBridge 暴露的接口。这是有意设计的：它可以防止 XSS 攻击获得 IPC 访问权限。

ipcMain.on 会监听通过 ipcRenderer.send 发送的单向消息（而不是 invoke）。这里没有自动的响应通道——这种模式适用于渲染进程不需要回复的通知或命令，例如记录事件或触发原生通知。

主进程可以使用 webContents.send('channel-name', data) 向渲染进程推送数据。这是主进程主动发起通信的主要方式——例如，将文件系统监视事件或原生菜单操作转发给 React 用户界面。

在预加载脚本中，ipcRenderer.on('update', callback) 会为来自主进程的推送消息注册监听器。回调会接收事件以及主进程发送的任何数据，然后您再通过 contextBridge 暴露的函数将其传递给渲染进程。

处理推送事件的一种清晰模式是：api.onUpdate = (callback) => ipcRenderer.on('update', (_event, data) => callback(data))。React 组件通过调用 window.api.onUpdate(setData) 进行订阅；当主进程推送新数据时，回调会更新状态。

每个 ipcRenderer.on 监听器在不再需要时都必须移除，以防止内存泄漏和重复回调。预加载函数应返回一个清理函数（例如，() => ipcRenderer.removeListener('update', callback)），React 会在 useEffect 的清理返回函数中调用它。

来自渲染进程的 IPC 输入在主进程处理程序中应被视为不可信数据。请始终验证文件路径（防止路径遍历攻击）、清理查询参数，并检查发送方的来源是否符合预期。切勿暴露通用的 eval 或 exec IPC 通道。

随着应用不断扩大，请使用命名空间约定来组织 IPC 通道，例如：'fs:read-file'、'db:query'、'window:minimize'。请将通道名称放在共享的常量文件中，并由 main.js 和预加载脚本同时导入，以防止拼写错误并使重构更加安全。

ipcMain.handle 处理程序返回的值会发生什么？

IPC 是 Electron 通信的骨干。ipcMain.handle 和 ipcRenderer.invoke 构成基于 Promise 的请求—响应对，用于处理由渲染进程发起的操作。对于由主进程发起的推送，webContents.send 和 ipcRenderer.on 协同工作。渲染进程中的所有 IPC 都必须通过预加载脚本的 contextBridge 路由，并且应始终清理监听器，以防止内存泄漏。