为何Electron的NODE_MODULE_VERSION与Node官方版本不匹配？

为什么Electron的NODE_MODULE_VERSION不匹配官方Node？ #

Electron并非直接使用官方Node.js的源码包，而是基于Chromium的V8引擎和Node.js的API层做了定制化修改：

• 为了适配Chromium的版本，Electron会同步升级V8引擎（往往比对应官方Node版本的V8更新），而NODE_MODULE_VERSION本质是V8引擎和Node内部ABI（应用二进制接口）的标识，一旦V8或内部ABI有变更，这个版本号就会改变。
• 官方Node的NODE_MODULE_VERSION仅对应其自身的V8和ABI版本，而Electron会独立维护这个标识，所以即便是基于同一段Node API版本（比如Node 16.x）开发的Electron版本，其NODE_MODULE_VERSION也会和官方Node不同。

比如你提到的Electron 19.1.3，虽然对外宣称基于Node 16.14.2的API，但它的V8版本和内部ABI已经做了适配Chromium的修改，因此NODE_MODULE_VERSION被设为106，而非官方Node 16.14.2的93。

解决版本不兼容错误的方案 #

除了手动重新编译模块，你可以通过以下方式避免重复遇到这个错误：

• 使用electron-rebuild自动适配：这是Electron官方推荐的工具，能自动识别当前Electron版本，重新构建所有原生依赖以匹配其ABI。执行命令：

  npx electron-rebuild
  

  也可以在package.json中添加脚本简化操作：

  "scripts": {
    "rebuild": "electron-rebuild"
  }
  

  之后只需运行npm run rebuild即可。
• 安装时指定Electron目标版本：在安装原生依赖时，直接告诉npm使用Electron的编译环境，无需后续手动rebuild：

  npm install --target=19.1.3 --disturl=https://electronjs.org/headers
  

• 优先选择支持Electron预编译的模块：多数流行原生模块（如sqlite3、sharp）会提供针对Electron各版本预编译的二进制包，安装时会自动匹配当前Electron的ABI，无需本地编译。
• 锁定版本依赖：在package.json中固定Electron版本（使用精确版本号而非范围），同时确保所有原生依赖的版本明确支持该Electron版本的ABI，避免因版本自动升级导致的不兼容。

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