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

问题背景

Electron Forge 是一个流行的 Electron 应用程序打包和分发工具。近期有开发者报告，在使用 Node.js 23.6 及以上版本时，基于 TypeScript 的 Forge 配置无法正常加载，而 Node.js 23.5 及以下版本则工作正常。

问题表现

当用户在 Node.js 23.6+ 环境中运行 npm run package 命令时，系统会抛出模块未找到的错误，具体表现为：

1. 无法加载 webpack 配置文件
2. 提示模块类型未指定且无法解析为 CommonJS
3. 警告模块将作为 ES 模块重新解析，这会带来性能开销

根本原因

这个问题源于 Node.js 23.6.0 版本中的一个重要变更：--experimental-strip-types 特性被默认启用。这个特性原本是实验性的类型剥离功能，用于在运行时去除 TypeScript 类型注解。当这个特性被启用后，影响了 Electron Forge 对 TypeScript 配置文件的加载方式。

解决方案

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

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

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

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

3. 等待官方修复： Electron Forge 团队已经修复了这个问题，新版本即将发布。

技术细节

这个问题涉及到 Node.js 模块系统的几个关键方面：

1. 模块解析策略：Node.js 23.6+ 对 TypeScript 文件的处理方式发生了变化
2. 类型剥离：实验性功能默认启用影响了模块加载过程
3. 模块类型推断：当 package.json 中未明确指定模块类型时，Node.js 会尝试自动推断

最佳实践建议

对于 Electron 开发者，建议：

1. 在项目 package.json 中明确指定模块类型
2. 关注 Node.js 版本更新带来的潜在兼容性问题
3. 对于生产环境，考虑锁定 Node.js 版本以避免意外变更

未来展望

随着 Electron Forge 新版本的发布，这个问题将得到官方修复。同时，这也提醒我们 TypeScript 工具链与 Node.js 运行时之间的集成仍在不断演进中，开发者需要保持对这类兼容性问题的关注。