npm start启动Angular项目报Node.js版本不兼容错误如何解决

报错信息已经明确指向核心问题：当前Node.js v10.16.3版本不满足项目所使用的Angular CLI的最低运行要求。你之前重装全局CLI的操作没有生效，核心误区是：

• npm start脚本中写死了调用项目本地路径下的Angular CLI：./node_modules/@angular/cli/bin/ng，你全局安装的@angular/cli@11根本没有被调用
• 从报错给出的版本要求（最低Node v14.15或v16.10）判断，你项目本地安装的Angular CLI版本至少为v13及以上，本身就不支持Node 10，和全局安装的v11版本没有关系

根据你是否需要保留Node.js v10环境，二选一操作即可：

方案一：升级Node.js版本（推荐，无需修改项目依赖） #

如果没有强制保留Node 10的需求，直接升级本地Node.js版本到要求范围：

• 安装v14.15+的14.x长期支持版，或者v16.10+的16.x长期支持版
• 升级完成后在项目目录执行node -v确认版本符合要求，直接运行npm start即可正常启动

方案二：保留Node.js v10环境，降级项目Angular依赖 #

如果必须使用当前Node 10版本，需要把项目内的Angular相关依赖全部降到兼容Node 10的版本，操作步骤：

1. 删除项目目录下的node_modules文件夹和package-lock.json文件
2. 打开根目录下的package.json，将所有@angular/开头的依赖（包括@angular/cli、@angular/core、@angular/common、@angular/compiler等）的版本号统一修改为11.x，和你全局安装的CLI大版本保持一致
3. 确认项目使用的@genesisui/angular版本兼容Angular 11，否则同步调整该包版本
4. 在项目目录执行npm install重新安装全量依赖
5. 依赖安装完成后执行npm start启动项目

• 在Angular项目目录下执行ng相关命令时，默认会优先调用项目本地node_modules中安装的CLI版本，只有项目本地没有安装@angular/cli时才会调用全局版本
• 所有@angular开头的依赖包必须保持相同大版本号，混用版本会触发大量兼容性报错
• npm 5及以上版本执行缓存清理需要加--force参数，即npm cache clean --force，不过该操作和本次报错无直接关联

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