Electron-forge打包应用窗口无法打开无报错（win10/Ubuntu20.04）

第一步：先获取实际报错信息 #

打包后点击无输出的情况下，手动执行应用程序抓取日志：

• Ubuntu系统：deb包默认安装在/opt/目录下，打开终端执行 /opt/[你的应用名称]/[你的应用名称] 即可看到运行时输出
• Windows系统：进入应用安装目录，在cmd中直接执行对应的exe文件，即可看到控制台错误输出

常见问题及修复方案 #

1. 相对路径引用错误 #

开发模式下路径默认基于项目根目录，打包后文件结构发生变化，硬写的相对路径会找不到资源：

• 入口页面加载必须用绝对路径拼接，写法示例：

mainWindow.loadFile(path.join(__dirname, 'index.html'))

• 所有静态资源、配置文件的引用都不要直接写./xxx这类相对路径，统一用__dirname或app.getAppPath()拼接绝对路径

2. 生产依赖缺失 #

检查package.json的依赖配置：

• 所有生产环境需要用到的依赖（包括第三方工具库、Node原生模块）必须放在dependencies字段下，放在devDependencies里的依赖不会被打进安装包
• 用到Node原生模块的话，需要用electron-rebuild针对你使用的Electron v16版本重新编译，避免版本不兼容

3. 窗口创建逻辑异常 #

检查主进程的窗口创建代码：

• 不要加仅开发环境才创建窗口的判断逻辑，例如if(process.env.NODE_ENV === 'development')包裹new BrowserWindow的代码，打包后环境变量为production会导致窗口不会被创建
• 检查是否设置了show: false但是没有在合适时机调用win.show()，开发环境的devTools触发逻辑可能会自动显示窗口，生产环境没有对应逻辑就会隐藏
• 检查webPreferences配置是否符合Electron v16的安全限制，未正确配置node集成、上下文隔离参数可能导致渲染进程报错卡死

4. electron-forge 打包配置错误 #

检查forge相关配置：

• 确认package.json的main字段指向正确的主进程入口文件，路径和打包后的文件结构匹配
• 确认forge配置的files字段没有把主进程入口、静态资源等必要文件排除在打包列表外

5. 环境兼容问题 #

• 如果是虚拟机环境运行，可在启动应用时加--disable-gpu参数测试，如果可以正常启动，就在主进程app.whenReady()之前添加代码：

app.commandLine.appendSwitch('disable-gpu')

• 检查是否有跨平台的路径写法问题，例如Windows下的反斜杠路径在Linux下不兼容，统一用path模块处理路径拼接

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