electron-builder打包后asar内无dist文件致加载报错如何配置解决

这个报错不是asar输出路径配置错误导致的，核心原因是electron-builder打包时没有将dist目录纳入打包文件列表，最终生成的app.asar里自然找不到对应路径的index.html，不存在单独的命令行参数能直接“指定dist打包位置”修复这个问题，需要从打包文件规则、构建流程两个方向调整。

• 优先检查构建顺序：必须在执行electron-builder命令前，先完成项目自身的编译构建，确保dist目录已经生成。可以直接修改publish脚本，把编译步骤前置，示例：

"scripts": {
  // 把npm run build替换成你项目实际生成dist目录的构建命令，比如vite build、react-scripts build等
  "publish": "npm run build && set GH_TOKEN=<my_token> && electron-builder --win -p always"
}

• 显式配置打包包含规则：electron-builder有默认的文件过滤规则，部分项目结构下会漏扫根目录的dist文件夹，两种配置方式二选一即可：
  1. 配置package.json中的build字段，固定打包规则（推荐）：

  "build": {
    "appId": "com.yourapp.my",
    "asar": true,
    "files": [
      "dist/**/*",
      // 下面按你项目实际情况补充主进程、preload等非dist目录下的运行依赖文件
      "main.js",
      "preload.cjs"
    ]
  }
  

  2. 临时通过命令行参数传入要包含的文件规则，不需要改package.json配置：

  "publish": "npm run build && set GH_TOKEN=<my_token> && electron-builder --win -p always --files \"dist/**/*\" --files \"main.js\""
  

  注意如果主进程、preload等运行必须的文件不在dist目录下，需要和dist规则一起传入，否则会出现其他文件缺失问题。

不需要每次打正式安装包验证，本地执行不带-p always的build命令后，找到输出目录下的win-unpacked/resources/app.asar文件，执行npx asar list app.asar的完整路径，查看输出的文件列表里存在dist/index.html，再进行安装测试即可。
额外排查点：检查build配置里的ignore字段，不要写匹配dist目录的排除规则，否则即使加了files配置也会被过滤掉。

内容的提问来源于stack exchange，提问作者Dev Minty