📦 Electron 应用打包教程(包含 C++ 后端 + 前端)
本教程将手把手指导你在 Windows 下使用 Electron + electron-builder 创建并打包一个桌面应用,假设你已经拥有:
- ✅ 已构建好的 前端页面(HTML/CSS/JS)
- ✅ 已编译好的 C++ 后端程序(如 exe 文件)
你将学会:安装 Node.js、配置 npm、初始化项目、设置国内镜像、安装 Electron 和 electron-builder,并打包为安装包。
📁 1. 新建项目文件夹
mkdir MyElectronApp
cd MyElectronApp
📥 2. 安装 Node.js(附带 npm)
-
打开官网下载安装:
- https://nodejs.org/
- 推荐选择 LTS 版本
-
安装完成后,打开 PowerShell 运行验证:
node -v # 查看 Node.js 版本
npm -v # 查看 npm 版本
🌐 3. 配置 npm 国内镜像(永久生效)
npm config set registry https://registry.npmmirror.com
验证:
npm config get registry
# 输出应为 https://registry.npmmirror.com
🛠 4. 初始化 npm 项目
npm init -y
这会创建一个默认的 package.json 文件。
📦 5. 安装 Electron 与 electron-builder
npm install electron --save-dev
npm install electron-builder --save-dev
📁 6. 项目结构建议
MyElectronApp/
├── dist/ # 前端构建后的文件(index.html)
├── backend/ # C++ 后端程序(已编译的 .exe 文件)
│ └── backend.exe
├── main.js # Electron 主进程入口
├── package.json # npm 配置
└── icon.ico # 应用图标(可选)
📄 7. 创建 main.js
const { app, BrowserWindow } = require('electron');
const path = require('path');
const { spawn } = require('child_process');
function createWindow() {
const win = new BrowserWindow({
width: 1000,
height: 800,
webPreferences: {
nodeIntegration: true,
contextIsolation: false
}
});
win.loadFile(path.join(__dirname, 'dist/index.html'));
// 启动后端程序(C++ 编译后的 exe 文件)
const backend = spawn(path.join(__dirname, 'backend/backend.exe'));
backend.stdout.on('data', data => console.log(`[后端] ${data}`));
backend.stderr.on('data', data => console.error(`[后端错误] ${data}`));
}
app.whenReady().then(createWindow);
⚙️ 8. 修改 package.json
添加启动命令和打包配置:
{
"name": "my-electron-app",
"version": "1.0.0",
"main": "main.js",
"scripts": {
"start": "electron .",
"build": "electron-builder"
},
"build": {
"appId": "com.example.myapp",
"productName": "MyElectronApp",
"directories": {
"output": "release"
},
"files": [
"main.js",
"dist/**/*",
"backend/**/*"
],
"win": {
"target": "nsis",
"icon": "icon.ico"
},
"nsis": {
"oneClick": false,
"perMachine": true,
"allowToChangeInstallationDirectory": true
}
},
"devDependencies": {
"electron": "^27.1.1",
"electron-builder": "^24.14.1"
}
}
⚠️ 如果没有图标文件,请删除
"icon": "icon.ico"。
▶️ 9. 运行与调试
npm start
📦 10. 打包为 Windows 安装包(.exe)
npm run build
结果会在 release/ 文件夹下生成:
- 安装包
.exe - 可执行文件
.exe(无需安装)
🧩 常见问题
-
后端无法运行?
- 请确认
backend/backend.exe是合法的可执行文件,且无依赖缺失。
- 请确认
-
路径报错?
- 请用
path.join(__dirname, ...)构建路径,避免硬编码。
- 请用
-
图标不显示?
- 请确保
icon.ico为标准.ico文件,最好为 256×256 像素。
- 请确保
✅ 你现在可以:
- 使用 PowerShell 一键运行或打包
- 整合任意前端(Vue/React/HTML)+ 后端(C++/Node.js/Python)
- 打包为桌面应用程序
&spm=1001.2101.3001.5002&articleId=148430499&d=1&t=3&u=f93f7b49b1e744ab9fcd2ed561c3aa35)
2万+

被折叠的 条评论
为什么被折叠?



