Electron启动报错：Missing script: 'start'问题求助

问题重现 #

在Windows 10环境下制作第一个Electron应用，执行以下步骤后运行npm start报错：

• 安装Node.js与npm
• 创建C:\electron-app文件夹
• 执行npm init -y生成package.json
• 安装Electron依赖：npm install --save-dev electron
• 手动修改package.json添加start脚本
• 创建空的main.js文件
• 执行npm start时提示：Missing script: 'start'

排查与解决步骤 #

1. 确认package.json的scripts配置 #

打开C:\electron-app\package.json，检查scripts字段是否正确配置了start命令：

{
  "name": "electron-app",
  "version": "1.0.0",
  "main": "main.js",
  "scripts": {
    "start": "electron ."
  },
  "devDependencies": {
    "electron": "^x.x.x"
  }
}

• 确保start脚本的值为electron .（注意空格）
• 检查引号、逗号等语法是否正确，JSON格式错误会导致npm无法识别脚本

2. 验证main.js的位置与package.json的main字段匹配 #

• 确认main.js文件位于C:\electron-app根目录下，没有被误放到子文件夹
• 检查package.json的main字段是否指向main.js，默认生成的配置应该已经包含该字段

3. 清理npm缓存并重新安装依赖 #

如果配置无误仍报错，可能是缓存或依赖安装异常：

# 清理npm缓存
npm cache clean --force

# 卸载并重新安装Electron
npm uninstall --save-dev electron
npm install --save-dev electron

4. 重新启动应用 #

保存package.json的修改后，在C:\electron-app目录下打开命令行，执行：

npm start

此时即使main.js为空，Electron也会启动一个空白窗口，不会再报脚本缺失错误。

内容的提问来源于stack exchange，提问作者Sébastien Lüdi