Vite+Electron 踩坑补坑全攻略：详解疑难杂症

项目目录名称不能含有中文

踩坑现象：

• 项目目录名称中包含中文时，可能会遇到无法下载和打包依赖的问题，导致打包软件失败。

补坑策略：

• 确保项目目录名称不包含中文，避免出现此类问题。

打包软件前可能缺失依赖包

踩坑现象：

• 每次打包软件前都可能缺失依赖包，需要手动在 package.json 文件的 dependencies 字段填写依赖名称和版本。

补坑策略：

• 安装 electron-builder 工具，在 package.json 文件的 scripts 字段中添加以下命令：

"scripts": {
  "build": "electron-builder --win --x64"
}

• 然后在终端中运行 npm run build 命令，即可自动下载并安装缺少的依赖包，并打包软件。

打包软件时无法输出安装程序

踩坑现象：

• 打包软件时，可能会遇到无法输出安装程序的问题。

补坑策略：

• 检查 electron-builder 的配置是否正确，尤其是 asar 和 win 两个字段的设置。
• 确保项目中没有使用不支持 Electron 的模块或库。
• 尝试使用不同的打包工具，如 electron-packager。

打包软件后体积过大

踩坑现象：

• 打包软件后，可能会发现体积过大。

补坑策略：

• 检查项目中是否存在不需要的文件或库，并将其删除。
• 尝试使用 electron-builder 的 asar 和 compression 选项来压缩软件体积。
• 使用 electron-packager 工具打包软件，其通常可以生成较小的软件体积。

打包软件后出现闪退问题

踩坑现象：

• 打包软件后，可能会遇到闪退问题。

补坑策略：

• 检查软件的日志文件，以确定闪退的原因。
• 尝试使用不同的打包工具，如 electron-packager。
• 确保项目中使用的 Electron 版本与打包工具的版本兼容。

打包软件后出现黑屏问题

踩坑现象：

• 打包软件后，可能会遇到黑屏问题。

补坑策略：

• 检查软件的日志文件，以确定黑屏的原因。
• 尝试使用不同的打包工具，如 electron-packager。
• 确保项目中使用的 Electron 版本与打包工具的版本兼容。

打包软件后出现白屏问题

踩坑现象：

• 打包软件后，可能会遇到白屏问题。

补坑策略：

• 检查软件的日志文件，以确定白屏的原因。
• 尝试使用不同的打包工具，如 electron-packager。
• 确保项目中使用的 Electron 版本与打包工具的版本兼容。

打包软件后出现崩溃问题

踩坑现象：

• 打包软件后，可能会遇到崩溃问题。

补坑策略：

• 检查软件的日志文件，以确定崩溃的原因。
• 尝试使用不同的打包工具，如 electron-packager。
• 确保项目中使用的 Electron 版本与打包工具的版本兼容。