**这是本文档旧的修订版!**
快速开始
Electron 用 HTML + CSS + JavaScript 就能写跨平台桌面应用(Windows / macOS / Linux)。它的本质是:主进程(Node.js)负责窗口和系统能力,渲染进程(Chromium 页面)负责界面,两者通过 IPC 通信。
一、环境准备
- 安装 Node.js LTS(建议 18 / 20 及以上),自带 npm;
node -v、npm -v能输出版本即可。 - 编辑器推荐 VS Code。
- 国内下载 Electron 二进制较慢时,先设置镜像:
npm config set registry https://registry.npmmirror.com npm config set electron_mirror https://npmmirror.com/mirrors/electron/
二、方式 A:一条命令起项目(推荐新手)
官方脚手架 Electron Forge 会生成完整工程,自带运行和打包脚本。
# 创建项目(默认模板) npm init electron-app@latest my-app cd my-app npm start
想要前端框架 / Vite 热更新模板,加一个 template 参数:
npx create-electron-app@latest my-app --template=vite npm start
生成的目录大致是这样:
my-app/
├── package.json # main 指向主进程入口,scripts.start 启动应用
├── forge.config.js # 打包配置(maker)
└── src/
├── main.js # 主进程:创建窗口、生命周期
├── preload.js # 预加载脚本:桥接安全 API
└── index.html # 渲染进程页面(界面)