为什么执行npm install -g @angular/cli全局安装命令运行失败？

问题出现原因 #

• 版本兼容性不匹配：Node.js 8.1.2为2017年发布的老旧版本，仅支持最高@angular/cli@6.x版本，直接执行默认安装命令会拉取最新版CLI，和低版本Node完全不兼容，是最常见的报错原因
• 网络访问异常：默认npm官方源在国内访问不稳定，易出现下载超时、资源缺失的问题
• 本地缓存损坏：之前安装失败的残留缓存会干扰后续安装流程
• 权限不足：Windows下cmd未以管理员身份运行时，全局包写入系统目录会触发权限报错

解决方法 #

方案1：适配现有Node版本安装兼容CLI #

如果暂时不需要升级Node.js，直接安装适配Node 8.x的最高稳定CLI版本即可：

npm install -g @angular/cli@6.2.9

安装完成后执行ng version即可验证安装结果。

方案2：升级Node.js后安装新版CLI（更推荐） #

如果需要使用新版Angular的功能，先卸载现有Node.js 8.1.2，安装16.x/18.x等长期支持版Node.js，完成后执行默认安装命令即可：

npm install -g @angular/cli

通用排查步骤 #

如果上述操作后仍安装失败，可依次尝试：

• 切换npm国内镜像源解决网络问题：

  npm config set registry https://registry.npmmirror.com
  

• 清除本地损坏的npm缓存：

  npm cache clean --force
  

• 右键点击cmd选择「以管理员身份运行」后，重新执行安装命令

内容的提问来源于stack exchange，提问作者jaime-lee