Mac端运行Ionic项目执行ionic serve报错(exit code 127)求助

核心问题分析 #

运行ionic serve时出现的readConfiguration is not a function和Workspace extension with invalid name (defaultProject) found错误，本质是Angular CLI与Ionic版本不兼容，或angular.json配置不符合新版本规范导致的。而尝试安装@ionic/app-scripts@latest出现Python报错，是因为该包已被Ionic 4+版本弃用，其依赖的node-gyp对Python环境有特定要求。

分步解决方案 #

1. 修正Angular CLI与Ionic版本兼容性 #

• 先查看当前项目依赖版本：

  ionic info
  ng version
  

• 确保@ionic/angular-toolkit和@angular/cli版本匹配，执行以下命令更新到兼容版本：

  npm install @ionic/angular-toolkit@latest --save-dev
  npm install @angular/cli@<对应兼容版本> --save-dev
  

2. 修复angular.json配置问题 #

• 打开项目根目录的angular.json文件，检查是否存在顶层的defaultProject字段：
  • 如果有，直接删除该字段（新版本Angular CLI不再允许顶层配置此参数）；
  • 确认projects节点下的目标项目配置完整，确保architect下的build、serve等配置正常。

3. 放弃安装@ionic/app-scripts，解决node-gyp Python报错（若其他依赖需要） #

• Ionic 4及以上版本已完全依赖Angular CLI构建，无需安装@ionic/app-scripts，之前的尝试属于错误方向，直接放弃该命令。
• 若其他依赖需要node-gyp编译（出现Python相关报错），按以下步骤配置：
  • 安装Xcode命令行工具（编译依赖）：

    xcode-select --install
    

  • 配置npm使用正确的Python版本：
    • 若安装的是Python 3.x：

      npm config set python python3
      

    • 若需要使用Python 2.7（部分旧依赖要求）：

      brew install python@2
      npm config set python /usr/bin/python2
      

最后验证 #

执行以下命令清理缓存并重新启动服务：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install
ionic serve

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