1. 为什么选择Electron打包Vue项目?
很多前端开发者都有这样的经历:辛辛苦苦开发了一个Vue项目,在浏览器里跑得飞起,但用户却希望能在桌面上直接双击打开使用。这时候Electron就派上用场了。Electron本质上是一个使用JavaScript、HTML和CSS构建跨平台桌面应用的框架,它把Chromium浏览器和Node.js打包在一起,让你的网页应用摇身一变成为桌面程序。
我去年接手过一个项目,客户明确要求要把Vue做的管理系统打包成exe文件。当时尝试了几种方案,最终发现Electron是最稳定、最成熟的解决方案。它不仅支持Windows,还能轻松打包macOS和Linux版本,这对需要跨平台分发的项目来说简直是福音。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与项目初始化
2.1 安装必备工具
在开始之前,确保你的开发环境已经准备好。首先需要安装Node.js(建议使用LTS版本),它会自带npm包管理器。我推荐使用nvm来管理Node.js版本,这样可以避免权限问题,也方便切换不同项目所需的Node版本。
bash复制# 检查Node.js和npm是否安装成功
node -v
npm -v
2.2 获取Electron快速启动模板
Electron官方提供了一个quick-start模板,这是我们打包的基础。我建议直接克隆这个仓库,而不是从头开始配置,可以省去很多麻烦。
bash复制git clone https://github.com/electron/electron-quick-start
cd electron-quick-start
npm install
npm start
运行成功后,你会看到一个简单的Electron窗口弹出。这个窗口目前加载的是模板自带的index.html,接下来我们要把它替换成我们Vue项目的输出。
3. Vue项目配置要点
3.1 关键配置:publicPath
这一步是很多新手容易踩坑的地方。Vue项目默认的publicPath是'/',这在Web服务器上运行没问题,但在Electron打包的本地环境中就会导致资源加载失败,出现白屏。
修改vue.config.js:
javascript复制module.exports = {
