Angular创建项目报ng未识别、npm run找不到package.json及node更新求助

问题排查与解决方案 #

1. ng命令不被系统识别修复 #

• 先校验全局Angular CLI安装状态：执行npm list -g @angular/cli，如果无对应版本输出，执行npm install -g @angular/cli重新安装全局依赖
• 校验npm全局路径环境变量配置：执行npm config get prefix获取npm全局安装根路径，将该完整路径添加到系统Path环境变量，配置完成后重启终端生效
• 若此前手动添加过Angular独立路径到环境变量，先删除该配置，优先使用上述npm全局路径，避免多版本路径冲突

2. npm run提示找不到package.json修复 #

• npm run系列命令必须在包含package.json文件的项目根目录下执行，你当前Angular项目创建失败，未生成对应项目目录与package.json文件，先解决项目创建问题后再执行对应命令即可
• 若在已有项目目录下执行仍然报错，检查当前终端工作路径是否匹配项目根目录，目录下是否存在拼写正确的package.json文件

3. Angular创建新项目报错排查 #

• 校验版本兼容性：不同版本Angular CLI对Node.js有严格的版本要求，执行node -v、ng version获取当前版本，核对版本匹配规则是否符合要求
• 清理缓存避免依赖损坏：执行npm cache clean --force清理npm本地缓存后重试创建项目
• 切换npm国内源避免网络问题：执行npm config set registry https://registry.npmmirror.com后重试，解决官方源不稳定导致的依赖拉取失败问题
• 避免在系统权限受限目录（如Windows的Program Files、系统目录等）下创建项目，切换到普通用户目录下操作
• 按上述步骤排查后仍报错，可粘贴执行ng new 项目名的完整终端报错文本，便于进一步定位问题

4. Node.js版本更新方法 #

Windows系统

• 方案1：直接下载对应需求的Node.js LTS版本安装包，运行安装程序直接覆盖原版本即可，安装时保持默认配置会自动更新环境变量
• 方案2：使用nvm-windows管理多版本Node.js，安装完成后执行nvm install lts安装最新长期支持版本，再执行nvm use [版本号]切换到对应版本即可

macOS/Linux系统

• 方案1：使用nvm工具管理Node.js版本，安装完成后重启终端，执行nvm install --lts安装最新LTS版本，执行nvm alias default lts/*设置为默认全局版本
• 方案2：通过Homebrew（macOS）、apt/yum（对应Linux发行版）等包管理器直接更新Node.js版本

内容的提问来源于stack exchange，提问作者sherif nasser