执行ng new无法创建Angular应用 ng --version运行异常求助
问题描述
按如下流程尝试创建Angular应用时出现故障:
- 步骤1:执行
ng new myapp - 步骤2:执行
cd myapp - 步骤3:执行
ng serve - 步骤4:浏览器访问
localhost:4200
执行步骤1后未成功生成项目文件,在Visual Studio Code中执行 ng --version 查看版本时触发异常,异常界面如下:
本地已预先安装Node.js环境,需排查解决该故障。
解决方案
故障核心原因基本是三类:Angular CLI全局安装损坏、Node.js版本与Angular版本不兼容、npm全局路径权限/缓存异常,按以下顺序操作即可修复:
验证Node.js基础环境
关闭所有已打开的VS Code窗口,新开系统原生终端(Windows用命令提示符/PowerShell,Mac/Linux用系统终端),依次执行:node -vnpm -v
如果任意一条命令提示“不是内部/外部命令”或“command not found”,先重新下载Node.js LTS版本安装,安装时务必勾选Add to PATH选项,安装完成后重启电脑再继续后续操作。彻底清理旧版CLI残留
执行命令卸载全局Angular CLI:npm uninstall -g @angular/cli
如果之前使用yarn安装过CLI,额外执行yarn global remove @angular/cli
手动删除全局node_modules路径下的@angular残留文件夹:
- Windows:打开资源管理器地址栏输入
%APPDATA%\npm\node_modules,删除其中的@angular文件夹 - Mac/Linux:进入
/usr/local/lib/node_modules路径,删除@angular文件夹
最后执行命令清理npm缓存:npm cache clean --force
- 版本匹配校验与重装CLI
Angular CLI对Node.js版本有严格要求,版本不匹配会直接导致命令运行异常:
- Angular 16及以上版本,要求Node.js版本为16.14.x、18.10.x或更高的LTS版本
- Angular 15版本,要求Node.js版本为14.20.x、16.13.x或18.10.x
如果当前Node.js版本不符合要求,先更换对应LTS版本重新安装。
版本匹配后执行命令重装CLI:npm install -g @angular/cli
安装完成后关闭所有终端,重新打开执行ng version,如果能正常输出Angular CLI、Node.js、npm的版本信息,说明CLI安装成功。
- 功能验证
重新执行ng new myapp,按提示选择路由、样式预处理器配置,等待依赖安装完成后进入项目目录执行ng serve,访问localhost:4200即可正常加载Angular默认欢迎页。
如果执行过程中仍报错,按错误类型对应处理:
- 权限类报错:Windows右键选择“以管理员身份运行”终端后重试,Mac/Linux在安装命令前加
sudo - 网络超时类报错:先执行
npm config set registry https://registry.npmmirror.com切换国内npm镜像,再重新执行安装、创建项目命令
内容的提问来源于stack exchange,提问作者Priya
相关产品推荐
相关产品推荐

