[!info] related notes

• 所属 MOC: Electron MOC
• 前置概念: Electron 进程模型, Electron 应用生命周期
• 并列概念: JavaScript 构建与 Electron 打包, 项目工程化实践（Vite）
• 关系笔记: Electron 架构总览

Electron 项目结构

一句话定义

Electron 项目结构最关键的不是“文件夹怎么命名”，而是按进程边界和运行时边界把代码分层。

核心内容

至少要分开的几层

• main：主进程入口、生命周期、窗口管理、高权限能力
• preload：桥接层、白名单 API、IPC 封装
• renderer：页面、组件、状态管理、前端交互
• shared：两侧都能复用的纯逻辑、类型、协议定义

为什么要这样拆

因为 Electron 不是单运行时项目。

如果不按边界拆，很容易出现：

• renderer 引进 main 才能用的代码
• preload 混进页面逻辑
• 构建时 main / preload / renderer 产物互相污染

一个实用原则

看到一段代码时，先问：

• 这段代码运行在哪个进程
• 它依赖的 API 属于哪个运行时
• 这段逻辑是否应该通过桥接层或共享层抽出来

边界与易混淆点

• 共享层不等于“随便什么都能共享”
• 真正能共享的通常是纯逻辑、类型、协议，而不是带 Electron 运行时依赖的代码