百度360必应搜狗淘宝本站头条
python判断字典是否为空crontab每周一执行aes和des区别安装指定版本npmadb pull
当前位置：网站首页 > IT知识 > 正文

零基础小白也能学会!手把手教你用Electron打包网页为桌面应用

liuian 2025-04-24 03:39 21 浏览



一、引言

Electron 是一款由 GitHub 开发的开源框架，允许开发者使用 HTML、CSS 和 JavaScript 构建跨平台的桌面应用程序。无论你是 Web 开发者，还是想将现有网页项目转化为桌面应用，Electron 都能轻松实现。本教程将带领你从零开始，完成从环境搭建到打包发布的完整流程。

二、环境准备

1. 安装 Node.js 和 npm

  • 访问 Node.js 官网 下载并安装 LTS 版本（推荐 v16.x 或更高）。
  • 安装完成后，打开终端输入以下命令验证是否成功：
node -v  # 查看 Node.js 版本  
npm -v   # 查看 npm 版本
  • 提示：若版本号未显示，请重启终端或检查环境变量配置。

2. 安装 Electron

在终端中执行以下命令，将 Electron 安装为开发依赖：

npm install --save-dev electron

注：后续教程中所有命令均需在项目根目录下执行。

三、创建项目结构

1. 初始化项目

mkdir my-electron-app  
cd my-electron-app  
npm init -y  # 生成默认的 package.json 文件

2. 创建核心文件

  • main.js（主进程文件，控制应用窗口）：
const { app, BrowserWindow } = require('electron');
const path = require('path');

function createWindow() {
  const win = new BrowserWindow({
    width: 1200,
    height: 800,
    webPreferences: {
      nodeIntegration: true,  // 允许 Node.js 集成（可选）
      contextIsolation: false  // 关闭上下文隔离（可选）
    }
  });

  // 加载本地 HTML 文件（或远程网页）
  win.loadFile('index.html'); 
  // 若需加载远程网页（如 GitHub Pages），改用：
  // win.loadURL('https://your-page-url.com');
}

app.whenReady().then(createWindow);

app.on('window-all-closed', () => {
  if (process.platform !== 'darwin') {
    app.quit();
  }
});
  • 代码说明：
    • BrowserWindow 定义窗口尺寸和加载内容。
    • app.whenReady() 确保 Electron 完全初始化后再创建窗口。
  • index.html（前端页面文件）：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>我的桌面应用</title>
  <style>
    body { margin: 0; padding: 20px; font-family: Arial; }
  </style>
</head>
<body>
  <h1>欢迎使用 Electron 打包应用！</h1>
  <p>这是一个由前端页面转化的桌面程序。</p>
</body>
</html>

四、运行与调试

1. 启动应用

在终端执行：

npm start

效果： 应用窗口将显示 index.html 的内容。

2. 调试技巧

  • 打开开发者工具：在 main.js 中添加 win.webContents.openDevTools()。
  • 热重载：安装 electron-reloader 后，在 main.js 引入：
require('electron-reloader')(module);

五、打包为可执行文件

1. 安装打包工具

推荐使用 electron-packager（简单易用）或 electron-builder（功能更强大）。

npm install --save-dev electron-packager  # 或 electron-builder

2. 配置 package.json

在 scripts 中添加打包命令：

"scripts": {
  "package-win": "electron-packager . MyAppName --platform=win32 --arch=x64 --icon=assets/icons/win/icon.ico --overwrite",
  "package-mac": "electron-packager . MyAppName --platform=darwin --arch=x64 --icon=assets/icons/mac/icon.icns --overwrite",
  "package-linux": "electron-packager . MyAppName --platform=linux --arch=x64 --icon=assets/icons/png/icon.png --overwrite"
}

参数说明：

  • --platform：目标平台（win32/macOS/linux）。
  • --arch：CPU 架构（x64/arm64 等）。
  • --icon：应用图标路径（需准备 .ico/.icns/.png 格式）。

3. 执行打包命令

npm run package-win  # 打包 Windows 版本

输出路径：
release-builds/MyAppName-win32-x64/

4. 使用 electron-builder（进阶）

在 package.json 中配置：

"build": {
  "appId": "com.example.myapp",
  "win": {
    "target": "nsis",  // 生成安装包
    "icon": "assets/icons/win/icon.ico"
  },
  "nsis": {
    "oneClick": false,  // 允许自定义安装路径
    "allowToChangeInstallationDirectory": true
  }
}

执行命令：

npm run dist  # 生成 .exe/.dmg/.deb 等安装包

六、常见问题解决

1. 打包时报错：Node.js 版本过高

在 package.json 的 scripts 中添加环境变量：

"scripts": {
  "package-win": "SET NODE_OPTIONS=--openssl-legacy-provider && electron-packager . MyAppName ...",
  "package-mac": "NODE_OPTIONS=--openssl-legacy-provider electron-packager . MyAppName ...",
  "package-linux": "NODE_OPTIONS=--openssl-legacy-provider electron-packager . MyAppName ..."
}

2. 应用图标不显示

  • 使用工具 icofx.ro 将图片转换为 .ico/.icns 格式。
  • 确保图标路径与 --icon 参数一致。

3. 路由模式冲突（Vue 项目）

若前端使用 Vue Router 的 history 模式，打包后可能白屏。修改为 hash 模式：

const router = new VueRouter({
  mode: 'hash',  // 关键修改
  routes: [...]
});

七、结束了


经由本教程，您已然熟稔了将前端网页借助 Electron 打包成桌面应用的核心技艺。

无论是仅仅用于简单地展示页面，比如基础的信息呈现、产品介绍等，还是致力于开发极为复杂的应用，例如涉及多个交互模块、大量数据处理以及复杂逻辑运算的应用程序，Electron 都能够给予强有力的支持。

若想要对应用进行进一步的优化，就可以去探索 asar 打包这一方式，它能够有效地隐藏源码，增强应用的安全性和保密性。此外，自动更新功能也是一个值得深入研究的方向。比如，当应用有新的版本发布时，自动更新功能能够及时提醒用户并在后台自动完成更新，为用户提供最新、最完善的使用体验，避免了用户手动查找和更新的繁琐过程。

感谢点赞关注收藏：）

相关推荐

深入解析 MySQL 8.0 JSON 相关函数:解锁数据存储的无限可能

引言在现代应用程序中，数据的存储和处理变得愈发复杂多样。MySQL8.0引入了丰富的JSON相关函数，为我们提供了更灵活的数据存储和检索方式。本文将深入探讨MySQL8.0中的JSON...

MySQL的Json类型个人用法详解（mysql json类型对应java什么类型）

前言虽然MySQL很早就添加了Json类型，但是在业务开发过程中还是很少设计带这种类型的表。少不代表没有，当真正要对Json类型进行特定查询，修改，插入和优化等操作时，却感觉一下子想不起那些函数怎么使...

MySQL的json查询之json_array（mysql json_search）

json_array顾名思义就是创建一个数组，实际的用法，我目前没有想到很好的使用场景。使用官方的例子说明一下吧。例一selectjson_array(1,2,3,4);json_array虽然单独...

头条创作挑战赛#一、LSTM 原理 长短期记忆网络

#头条创作挑战赛#一、LSTM原理长短期记忆网络（LongShort-TermMemory，LSTM）是一种特殊类型的循环神经网络（RNN），旨在解决传统RNN在处理长序列数据时面临的梯度...

TensorBoard最全使用教程:看这篇就够了

机器学习通常涉及在训练期间可视化和度量模型的性能。有许多工具可用于此任务。在本文中，我们将重点介绍TensorFlow的开源工具套件，称为TensorBoard，虽然他是TensorFlow...

图神经网络版本的Kolmogorov Arnold(KAN)代码实现和效果对比

本文约4600字，建议阅读10分钟本文介绍了图神经网络版本的对比。KolmogorovArnoldNetworks(KAN)最近作为MLP的替代而流行起来，KANs使用Kolmogorov-Ar...

kornia，一个实用的 Python 库!（python kkb_tools）

大家好，今天为大家分享一个实用的Python库-kornia。Github地址：https://github.com/kornia/kornia/Kornia是一个基于PyTorch的开源计算...

图像分割掩码标注转YOLO多边形标注

Ultralytics团队付出了巨大的努力，使创建自定义YOLO模型变得非常容易。但是，处理大型数据集仍然很痛苦。训练yolo分割模型需要数据集具有其特定格式，这可能与你从大型数据集中获得的...

[python] 向量检索库Faiss使用指北

Faiss是一个由facebook开发以用于高效相似性搜索和密集向量聚类的库。它能够在任意大小的向量集中进行搜索。它还包含用于评估和参数调整的支持代码。Faiss是用C++编写的，带有Python的完...

如何把未量化的 70B 大模型加载到笔记本电脑上运行?

并行运行70B大模型我们已经看到，量化已经成为在低端GPU（比如Colab、Kaggle等）上加载大型语言模型（LLMs）的最常见方法了，但这会降低准确性并增加幻觉现象。那如果你和你的朋友们...

ncnn+PPYOLOv2首次结合!全网最详细代码解读来了

编辑：好困LRS【新智元导读】今天给大家安利一个宝藏仓库miemiedetection，该仓库集合了PPYOLO、PPYOLOv2、PPYOLOE三个算法pytorch实现三合一，其中的PPYOL...

人工智能——图像识别（人工智能图像识别流程）

概述图像识别（ImageRecognition）是计算机视觉的核心任务之一，旨在通过算法让计算机理解图像内容，包括分类（识别物体类别）、检测（定位并识别多个物体）、分割（像素级识别）等，常见的应用场...

PyTorch 深度学习实战(15):Twin Delayed DDPG (TD3) 算法

在上一篇文章中，我们介绍了DeepDeterministicPolicyGradient(DDPG)算法，并使用它解决了Pendulum问题。本文将深入探讨TwinDelayed...

大模型中常用的注意力机制GQA详解以及Pytorch代码实现

分组查询注意力(GroupedQueryAttention)是一种在大型语言模型中的多查询注意力(MQA)和多头注意力(MHA)之间进行插值的方法，它的目标是在保持MQA速度的同时...

pytorch如何快速创建具有特殊意思的tensor张量?

专栏推荐正文我们通过值可以看到torch.empty并没有进行初始化创建tensor并进行随机初始化操作，常用rand/rand_like,randint正态分布（0，1）指定正态分布的均值还有方差i...

一周热门
最近发表
标签列表