执行ng serve时出现Workspace extension with invalid name (defaultProject)错误求助

核心问题分析 #

这个报错的本质是Angular CLI解析angular.json时，发现defaultProject被错误地放在了「扩展（extensions）」节点下，不符合Angular工作区配置的规范结构。

具体解决步骤 #

• 修正angular.json结构
  打开你的angular.json，确保defaultProject是直接放在配置文件的顶层（和projects、schematics同级），而非嵌套在extensions或其他错误节点中。正确的顶层结构示例：

  {
    "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
    "version": 1,
    "newProjectRoot": "projects",
    "defaultProject": "your-project-name",
    "projects": {
      // 你的项目配置内容
    },
    // 其他配置项（如schematics、cli等）
  }
  

  同时删除所有错误位置的defaultProject键值对。

• 检查CLI与依赖版本兼容性
  运行ng version查看Angular CLI和项目核心依赖的版本是否匹配。如果版本差异较大，执行以下命令更新：

  # 更新全局CLI
  npm install -g @angular/cli
  # 更新项目依赖
  ng update @angular/cli @angular/core
  

• 清理依赖缓存并重装
  执行以下命令清理旧依赖和缓存，避免缓存导致的解析问题：

  # macOS/Linux
  rm -rf node_modules package-lock.json
  # Windows
  rmdir /s /q node_modules && del package-lock.json
  # 重新安装依赖
  npm install
  

• 验证配置有效性
  运行ng config get defaultProject，如果能正确返回你的项目名称，说明配置已修复，再尝试执行ng serve。

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