如何正确搭配TypeScript使用electron-nightly？

核心问题分析 #

你遇到的MODULE_NOT_FOUND是因为直接运行electron .时，系统会查找全局或本地的electron包，而你安装的是electron-nightly，两者CLI入口路径不同；类型导入错误则是因为electron-nightly的类型定义是为兼容electron导入路径设计的，并非独立模块。

疑问解答与分步解决 #

1. 是否需要额外安装electron包？如何绑定electron-nightly？

不需要安装electron包，同时存在electron和electron-nightly会直接导致类型冲突。绑定electron-nightly的关键是调用它的本地CLI：

• 方法一：用npx直接调用本地包

  npx electron-nightly .
  

• 方法二：在package.json的scripts中添加启动命令（更推荐）

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

  之后运行npm run start即可启动应用。

2. main.ts应该导入哪个包？解决“不是模块”错误

保持import { app } from 'electron'的导入方式，原因如下：

• electron-nightly的类型定义文件是为覆盖electron的类型设计的，并非作为独立模块导出，直接导入electron-nightly会触发TS2306错误。
• 确保tsconfig.json的compilerOptions.types中只保留node和electron-nightly，移除任何electron相关配置：

  {
    "compilerOptions": {
      "types": ["node", "electron-nightly"],
      "module": "NodeNext", // 适配ESM
      "moduleResolution": "NodeNext",
      "target": "ES2020",
      "esModuleInterop": true,
      "skipLibCheck": true
    }
  }
  

• 若之前安装过electron包，务必卸载：

  npm uninstall electron
  

3. Electron-Forge打包是否会有问题？

会有配置调整需求，需要让Forge明确使用electron-nightly：

• 在forge.config.js（或forge.config.ts）中指定electronPath：

  module.exports = {
    packagerConfig: {
      electronPath: require.resolve('electron-nightly')
    },
    // 其他Forge配置...
  }
  

• 或者确保package.json的devDependencies中只有electron-nightly作为Electron依赖，部分Forge版本会自动识别，若识别失败则手动指定上述路径即可。

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