已安装Node.js v14.20.0，运行ionic build仍触发Angular CLI版本报错求助

已安装Node.js v14.20.0，直接执行node --version返回v14.20.0，但运行ionic build时，Angular CLI检测到的Node.js版本为v14.15.0，提示需升级至v14.20、v16.13或v18.10以上版本。

执行命令及报错日志 #

PS C:\asu-mobile\moodleapp> ionic build
> npm.cmd run ionic:build:before

> moodlemobile@4.0.2 ionic:build:before C:\asu-mobile\moodleapp
> gulp

[15:41:18] Using gulpfile C:\asu-mobile\moodleapp\gulpfile.js
[15:41:18] Starting 'default'...
[15:41:18] Starting 'lang'...
[15:41:18] Starting 'env'...
[15:41:19] Finished 'env' after 744 ms
[15:41:20] Finished 'lang' after 1.32 s
[15:41:20] Finished 'default' after 1.32 s
> ng.cmd run app:build
Node.js version v14.15.0 detected.
The Angular CLI requires a minimum Node.js version of either v14.20, v16.13 or v18.10.

Please update your Node.js version or visit https://nodejs.org/ for additional instructions.

[ERROR] An error occurred while running subprocess ng.
        
        ng.cmd run app:build exited with exit code 3.
        
        Re-running this command with the --verbose flag may provide more information.
PS C:\asu-mobile\moodleapp> node --version
v14.20.0

问题原因 #

• 版本管理工具冲突：如果使用nvm、volta等Node.js版本管理工具，当前项目可能被锁定在v14.15.0版本，全局版本与项目本地版本不一致
• 终端环境变量优先级：终端的环境变量中，旧版本Node.js的路径优先级高于全局v14.20.0的路径，导致ng命令调用了旧版本
• npm脚本环境隔离：ionic build触发的npm子进程可能在独立环境中运行，未继承全局Node.js的环境配置

解决办法 #

• 切换项目Node.js版本：
  • 若使用nvm：执行nvm list查看已安装版本，执行nvm use 14.20.0切换到目标版本；若需永久锁定，在项目根目录创建.nvmrc文件写入14.20.0
  • 若使用volta：执行volta pin node@14.20.0锁定项目的Node.js版本
• 刷新终端环境变量：关闭当前PowerShell窗口重新打开，或执行以下命令手动刷新路径：

  $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
  

• 检查项目本地Node.js：查看项目目录下是否存在本地Node.js安装文件或缓存，删除后重新运行命令
• 重新安装Angular CLI：全局重新安装与Node.js版本匹配的Angular CLI：

  npm uninstall -g @angular/cli
  npm install -g @angular/cli@14.x  # 14.x版本适配Node.js 14.20.0
  

内容的提问来源于stack exchange，提问作者Amira Elsayed Ismail