Electron Forge 在 Node.js 23.6+ 版本中的 TypeScript 配置加载问题解析

问题背景

Electron Forge 是一个强大的 Electron 应用程序打包和分发工具。近期，用户在使用 Node.js 23.6 及以上版本时遇到了一个关键问题：当项目采用 TypeScript 配置时，Forge 无法正确加载配置文件，导致打包过程失败。

问题表现

当用户在 Node.js 23.6 及以上版本环境中运行 npm run package 命令时，系统会抛出模块未找到的错误，具体表现为无法加载 webpack 配置文件。错误信息中特别提到了 TypeScript 文件解析问题，并建议在 package.json 中添加 "type": "module" 配置。

根本原因

这个问题源于 Node.js 23.6.0 版本中取消了对 --experimental-strip-types 特性的标记。这个变化影响了 Electron Forge 导入功能的方式，导致 TypeScript 配置文件无法被正确解析。

解决方案

目前有以下几种临时解决方案：

1. 禁用类型剥离特性： 在运行命令前设置环境变量：

   NODE_OPTIONS="--no-experimental-strip-types" npm run package
   

   对于 Windows 用户：

   $ENV:NODE_OPTIONS="--no-experimental-strip-types"
   npm run start
   

2. 降级 Node.js 版本： 将 Node.js 版本降至 23.5 或以下可以避免此问题。

长期解决方案

Electron Forge 开发团队已经意识到这个问题，并在代码库中进行了修复。预计在下一个版本发布中，这个问题将得到彻底解决。开发团队表示将在近期发布包含此修复的新版本。

技术细节

这个问题涉及到 Node.js 对 ES 模块和 TypeScript 的处理方式变化。在 Node.js 23.6+ 中，默认的类型剥离行为与 Electron Forge 的模块导入机制产生了冲突。当 Node.js 尝试解析 TypeScript 配置文件时，由于类型剥离特性的影响，导致模块路径解析失败。

最佳实践建议

对于 Electron 开发者，建议：

1. 在问题完全修复前，暂时使用 Node.js 23.5 或以下版本进行开发
2. 密切关注 Electron Forge 的版本更新，及时升级到包含修复的版本
3. 对于生产环境，考虑锁定 Node.js 版本以避免不可预期的兼容性问题

这个问题虽然影响开发流程，但通过上述解决方案可以有效规避，不会对最终打包结果产生影响。