Electron调用dialog.showMessageBox报错：Cannot read property 'showMessageBox' of undefined

嘿，这个错误我之前也踩过同款坑！咱们先把问题根源拆解清楚：

错误核心原因 #

你是直接用纯Node.js环境运行了Electron专属代码，这就像把只能在浏览器里跑的JS代码丢去Node执行，肯定出问题。具体细节：

• Electron的electron模块不是Node原生模块，纯Node环境下require('electron')返回的对象是不完整的，根本找不到dialog这个属性，所以才会抛出"Cannot read property 'showMessageBox' of undefined"的错误。
• 就算是在Electron环境里，dialog属于主进程API，也得等Electron的app对象完全准备就绪后才能调用，你直接在代码顶层调用也可能触发异常。

一步步解决问题 #

按下面的操作来，保证能跑通：

1. 确认项目是标准Electron项目
   如果还没初始化项目，先在项目目录执行这两个命令：

   npm init -y
   npm install electron --save-dev
   

2. 修正你的app.js代码
   新版本Electron的showMessageBox已经改成异步Promise格式，而且必须等app初始化完成才能调用，调整后的代码如下：

   const { app, dialog, BrowserWindow } = require('electron');
   
   // 等待Electron应用初始化完成
   app.whenReady().then(() => {
     // 创建一个主窗口（部分对话框需要依附窗口，也可以传null）
     const mainWindow = new BrowserWindow({ width: 800, height: 600 });
   
     // 调用对话框，传入窗口实例（可选）和配置项
     dialog.showMessageBox(mainWindow, {
       type: 'info',
       title: '测试对话框',
       message: '这是Electron对话框的示例',
       buttons: ['确定', '取消']
     }).then(result => {
       console.log(`用户点击了第${result.response}个按钮`);
     }).catch(err => {
       console.error('对话框调用出错:', err);
     });
   });
   

3. 配置正确的启动命令
   打开项目的package.json，在scripts字段里添加启动脚本：

   "scripts": {
     "start": "electron ."
   }
   

4. 启动应用
   别再用node app.js启动了，执行这个命令：

   npm start
   

额外提醒 #

• 如果你是在渲染进程（比如网页中的JS代码）想调用对话框，现在不推荐用remote模块了（新版本Electron默认禁用），最佳实践是用ipcRenderer给主进程发消息，让主进程去调用dialog。
• 旧版Electron的showMessageBox是同步写法，但现在官方推荐用异步Promise写法，兼容性和稳定性更好。

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