Angular项目启动报错、npm依赖安装失败问题求助

首先明确故障关联逻辑：ng serve -o执行时提示找不到@angular-devkit/build-angular/package.json，根本原因不是该模块文件异常丢失，是之前执行npm install流程时被node-sass编译错误中途截断，项目核心依赖没有完整拉取安装，所有操作的核心是先打通node-sass的编译阻塞节点，完成全量依赖安装后，构建类报错会自然消除。

操作步骤 #

• 清理本地残留的错误依赖与缓存
  • 手动删除项目目录下的node_modules文件夹、package-lock.json文件
  • 执行命令清理npm本地缓存：npm cache clean --force
• 解决node-sass编译的Python2路径识别问题（适配Windows + Node 14.16.1环境）
  • 确认本地Python 2.7版本的安装路径严格匹配C:\Python27，避免自定义安装路径导致路径识别偏差
  • 执行命令将Python路径写入npm全局配置：npm config set python C:\Python27\python.exe
  • 同步安装Visual Studio Build Tools 2019，在安装组件中勾选“使用C++的桌面开发”选项，满足node-gyp编译原生模块的基础要求
  • 免编译替代方案：如果不想配置本地编译环境，可直接移除node-sass依赖，替换为官方适配的Dart Sass依赖，执行命令：npm uninstall node-sass && npm install sass --save-dev，该方案无原生编译流程，不会触发node-gyp的Python环境检查，可从根源绕开编译报错
• 全量安装项目依赖
  • 执行npm install拉取全量项目依赖，等待流程无报错完成
  • 手动校验核心依赖文件存在：确认路径node_modules/@angular-devkit/build-angular/package.json下的文件可以正常读取
• 启动项目验证
  • 执行ng serve -o启动应用，确认无模块缺失类异常

高频踩坑提醒 #

• 不要将Python3路径配置给npm/node-gyp，Node 14版本配套的node-sass 4.x编译链路完全不兼容Python3，强制配置会触发语法解析类报错
• 不要仅修改系统PATH环境变量，必须通过npm config set命令将Python路径写入npm全局配置，部分场景下npm的配置优先级会覆盖系统环境变量配置
• 如果之前手动下载过node-sass预编译二进制文件，需先清理本地缓存的二进制文件，避免版本不匹配触发二次编译流程，导致报错重复出现

内容的提问来源于stack exchange，提问作者Ashiqur Rahman