Angular CLI 12.1运行提示Node版本不匹配与package.json配置冲突问题
问题原因
这是Angular CLI 12.1.x版本的已知配置不一致问题:
@angular/cli12.1.0的package.json中engines字段确实标注Node版本要求为^12.14.1 || >=14.0.0,但CLI内部硬编码的运行时版本校验规则和该声明不一致:为了规避Node.js 14.0~14.14版本的已知兼容性缺陷,官方在运行时代码中额外要求14.x分支的Node版本必须≥14.15,12.x分支必须≥12.14。你当前使用的v14.3.0属于14.x分支中低于14.15的版本,因此触发了报错。
解决办法
- 方案一(推荐):升级Node.js版本到14.15.0及以上的14.x LTS版本,或更高的长期支持版本(如16.x),可完全兼容Angular CLI 12.1的所有要求。
- 方案二(临时适配):如果暂时无法升级Node版本,可临时禁用Angular CLI的版本校验:
- Windows CMD环境执行:
set NG_DISABLE_VERSION_CHECK=1 - Windows PowerShell环境执行:
$env:NG_DISABLE_VERSION_CHECK=1 - Linux/macOS环境执行:
export NG_DISABLE_VERSION_CHECK=1
ng serve或ng v即可正常执行。 - Windows CMD环境执行:
- 方案三(不推荐):将Node版本降级到12.14.1~12.x范围内的版本,也可满足校验要求,但12.x版本已停止官方维护,存在安全风险。
内容的提问来源于stack exchange,提问作者Никита Середа
相关产品推荐
相关产品推荐

