You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

执行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全局路径权限/缓存异常,按以下顺序操作即可修复:

  1. 验证Node.js基础环境
    关闭所有已打开的VS Code窗口,新开系统原生终端(Windows用命令提示符/PowerShell,Mac/Linux用系统终端),依次执行:
    node -v
    npm -v
    如果任意一条命令提示“不是内部/外部命令”或“command not found”,先重新下载Node.js LTS版本安装,安装时务必勾选Add to PATH选项,安装完成后重启电脑再继续后续操作。

  2. 彻底清理旧版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
  1. 版本匹配校验与重装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安装成功。
  1. 功能验证
    重新执行 ng new myapp,按提示选择路由、样式预处理器配置,等待依赖安装完成后进入项目目录执行 ng serve,访问localhost:4200即可正常加载Angular默认欢迎页。

如果执行过程中仍报错,按错误类型对应处理:

  • 权限类报错:Windows右键选择“以管理员身份运行”终端后重试,Mac/Linux在安装命令前加sudo
  • 网络超时类报错:先执行 npm config set registry https://registry.npmmirror.com 切换国内npm镜像,再重新执行安装、创建项目命令

内容的提问来源于stack exchange,提问作者Priya

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 00:39:46