Electron入门应用打包exe（windows）

封面图 • 2025-11-02 • Windows

在 Windows 上使用 Electron 打包你的应用为 `.exe` 文件，通常会用到 **Electron Builder** 或 **Electron Packager**。下面是一个完整的步骤指南，帮助你将 Electron 应用打包成可执行文件（`.exe`）。

---

## ✅ 一、准备工作

确保你已经安装了以下工具：

1. **Node.js 和 npm**  
   安装地址：https://nodejs.org/  
   安装完成后，在命令行中运行以下命令确认是否安装成功：
   ```bash
   node -v
   npm -v
   ```

2. **Electron 项目结构**  
   确保你的项目结构类似如下：
   ```
   your-app/
   ├── package.json
   ├── main.js (主进程入口)
   └── index.html (渲染进程)
   ```

---

## ✅ 二、安装 Electron

如果你还没有安装 Electron，请运行：

```bash
npm install electron --save-dev
```

---

## ✅ 三、安装 Electron Builder（推荐）

Electron Builder 是一个功能强大的打包工具，支持生成 `.exe`、`.dmg`、`.deb` 等多种格式。

### 1. 安装 Electron Builder

```bash
npm install electron-builder --save-dev
```

### 2. 修改 `package.json`

添加或修改以下字段：

```json
{
  "name": "your-app",
  "version": "1.0.0",
  "main": "main.js",
  "scripts": {
    "start": "electron .",
    "build": "electron-builder build --win"
  },
  "build": {
    "appId": "com.example.yourapp",  // 可以自定义
    "productName": "YourApp",
    "win": {
      "target": "exe"
    }
  }
}
```

> 注意：`appId` 是应用的唯一标识符，建议使用反向域名格式（如 `com.yourcompany.yourapp`）。

---

## ✅ 四、构建 EXE 文件

在项目根目录下运行以下命令：

```bash
npm run build
```

这将会在项目目录下生成一个 `dist` 文件夹，里面包含 `.exe` 安装文件。

---

## ✅ 五、生成的文件路径

构建完成后，你会在 `dist/win-unpacked` 中看到未压缩的程序文件，而在 `dist/win` 中是 `.exe` 安装文件。

例如：

```
dist/
├── win/
│   └── YourApp-1.0.0.exe
```

---

## ✅ 六、其他选项（可选）

### 1. 添加图标（.ico）

你可以为 `.exe` 添加图标，只需在 `package.json` 的 `build` 配置中指定：

```json
"build": {
  "icon": "icon.ico",
  ...
}
```

将 `icon.ico` 放在项目根目录。

### 2. 自定义版本号

可以在 `package.json` 中修改 `version` 字段。

---

## ✅ 七、常见问题

### ❗ 问题：找不到 `electron-builder` 命令？

确保你已经正确安装了 `electron-builder`，并且 `npm run build` 正确执行。

### ❗ 问题：打包失败？

尝试运行：

```bash
npm install --force
```

或者检查是否有权限问题（建议使用管理员权限运行命令提示符）。

---

## ✅ 八、推荐工具

| 工具 | 特点 |
|------|------|
| [Electron Builder](https://www.electron.build/) | 功能强大，支持多平台，推荐使用 |
| [Electron Packager](https://github.com/electron/electron-packager) | 轻量级，适合简单打包 |

---

## ✅ 九、总结

| 步骤 | 内容 |
|------|------|
| 1 | 安装 Node.js 和 Electron |
| 2 | 使用 `electron-builder` 打包 |
| 3 | 运行 `npm run build` 生成 `.exe` |
| 4 | 查看 `dist/win` 获取安装文件 |

---

如果你需要我帮你写一个简单的 Electron 示例项目并打包成 `.exe`，也可以告诉我！我可以直接提供代码和配置。