Electron 安装

Electron 安装指南（2025 年 12 月最新）

当前 Electron 最新稳定版本为 39.2.7（基于 Chromium 142.x，发布于 2025 年 12 月左右）。Electron 不需要全局安装，通常作为项目依赖本地安装。

1. 前置要求（Prerequisites）

• Node.js 和 npm：安装最新 LTS 版本（推荐 Node.js 22.x 或更高）。
  下载地址：https://nodejs.org/
  验证安装：

  node -v
  npm -v

（macOS 用户建议用 Homebrew 或 nvm 安装，避免权限问题。）

• 代码编辑器：推荐 Visual Studio Code（VS Code）。
• 命令行工具：Windows 用 PowerShell/Command Prompt，macOS/Linux 用 Terminal。
• 可选：Git（用于版本控制）。

2. 创建项目并安装 Electron

推荐本地安装（作为 devDependency），这样每个项目可使用特定版本。

# 创建项目文件夹
mkdir my-electron-app
cd my-electron-app

# 初始化 package.json
npm init -y

# 安装 Electron（最新稳定版）
npm install electron@latest --save-dev

# 或指定版本（如当前最新）
npm install electron@39.2.7 --save-dev

你也可以用 yarn 或 pnpm：

yarn add electron@latest --dev
pnpm add electron@latest -D

注意：不推荐全局安装（npm install -g electron），因为 Electron 会捆绑自己的 Node.js 运行时，与系统 Node 版本无关。

3. 快速验证安装（Hello World 示例）

修改 package.json 添加启动脚本：

{
  "name": "my-electron-app",
  "version": "1.0.0",
  "main": "main.js",
  "scripts": {
    "start": "electron ."
  },
  "devDependencies": {
    "electron": "^39.2.7"
  }
}

创建 main.js（主进程文件）和 index.html（参考之前的教程内容）。

然后运行：

npm start

如果看到 Electron 窗口弹出，说明安装成功！

进阶推荐

• 使用脚手架工具快速搭建：
  Electron Forge（官方推荐）：

  npm install --global @electron-forge/cli
  npx electron-forge import  # 在现有项目中导入
  # 或创建新项目
  npm init electron-app@latest my-app

• 更多详情参考官方文档：https://www.electronjs.org/docs/latest/tutorial/tutorial-prerequisites

安装过程很简单，遇到问题（如网络慢、权限错误）可以试用镜像源或 VPN。如果有具体错误信息，贴出来我帮你排查！