如何解决终端持续提示Node.js版本不符合Angular CLI要求的问题？

问题现象 #

每次打开终端都会收到以下错误提示：

Node.js version v18.1.0 detected.
The Angular CLI requires a minimum of v18.13.

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

但实际本地安装的环境版本为：

• Node.js：v20.12.1
• Angular CLI：v17.3.7
• npm：10.7.0

已尝试卸载重装Node.js和Angular CLI，问题仍未解决，推测与实际安装状态无关。

排查及解决步骤 #

1. 确认终端使用的Node路径 #

终端可能加载了旧版本的Node执行路径，运行对应命令查看当前Node的实际路径：

# Linux/macOS
which node

# Windows
where node

若输出路径不是v20.12.1的安装目录，需调整系统环境变量，将正确的Node安装路径移至环境变量列表最顶端。

2. 清理Angular CLI缓存与残留配置 #

• 强制清除npm缓存：

npm cache clean --force

• 全局卸载Angular CLI并删除本地配置目录：

npm uninstall -g @angular/cli

# Linux/macOS 删除Angular配置目录
rm -rf ~/.angular

# Windows 删除Angular配置目录
rd /s /q %USERPROFILE%\.angular

• 重新全局安装指定版本的Angular CLI：

npm install -g @angular/cli@17.3.7

3. 检查终端启动脚本的版本指定 #

部分终端启动时会自动加载Node版本管理工具（如nvm、fnm），可能强制切换到旧版本。检查以下配置文件：

• Linux/macOS：~/.bashrc、~/.bash_profile、~/.zshrc
• Windows：PowerShell的$PROFILE文件
  若存在nvm use 18.1.0这类指定版本的命令，直接注释或删除即可。

4. 检查项目本地的版本配置文件 #

如果项目根目录存在.nvmrc、.node-version这类文件，可能指定了旧Node版本，导致终端进入项目时自动切换。修改文件内的版本号为20.12.1，或直接删除该文件。

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