如何检测npm依赖包要求的Node版本不高于父包指定的最低Node版本

解决方案 #

方案1：使用npm原生配置（无需额外依赖）

npm本身提供了引擎严格校验开关，开启后只要依赖声明的Node版本和当前运行的Node版本不兼容，就会直接抛出错误终止执行，刚好匹配你的需求：

• 方式一：在项目根目录新建/编辑.npmrc文件，添加如下配置：

  engine-strict = true
  

  配置后无论本地还是CI环境执行npm i、npm ci都会自动执行严格校验。
• 方式二：不在项目里加配置，直接在CI的执行命令中传入参数：

  npm ci --engine-strict
  

  命令执行后如果存在依赖的Node版本要求高于当前运行的Node版本（你场景里的Node12），会直接返回非零退出码，CI会自动识别为执行失败。

方案2：使用专用校验工具（适合更复杂的校验规则）

如果需要对比父包声明的Node版本和所有依赖的Node版本，而不依赖CI运行的Node版本，可使用第三方校验工具实现：

1. 安装校验工具为开发依赖：

   npm install -D npm-engines-checker
   

2. 在package.json中添加执行脚本：

   "scripts": {
     "check-node-version": "npm-engines-checker"
   }
   

3. 在CI流程中npm ci执行完成后，运行npm run check-node-version即可。工具会自动读取父包的engines.node配置，遍历所有依赖的对应配置做对比，有不兼容的情况会直接报错退出。

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