执行ng serve --open报Angular CLI非工作区命令不可用如何解决

Error: This command is not available when running the Angular CLI outside a workspace 是Angular CLI的路径类通用错误，触发核心原因是：执行命令的终端当前所在目录，不是Angular项目的根工作区。
Angular CLI判定工作区的唯一依据是当前目录（或逐级向上的父目录）中是否存在angular.json工作区配置文件，找不到该文件时就会判定当前环境不属于合法Angular项目，直接拦截ng serve这类项目级命令。
结合新手常见操作场景，90%以上的报错属于以下两种情况：

• 执行ng new <项目名>完成项目创建后，没有进入生成的项目文件夹，直接在创建命令所在的上层目录执行启动命令
• 终端路径切到了项目的子目录（比如src、node_modules文件夹），不在存放angular.json的根层级

1. 先确认终端当前所在路径：
   • Windows终端直接执行cd，会输出当前所在目录
   • Mac/Linux终端执行pwd输出当前路径
2. 找到本地存放angular.json文件的项目根文件夹，执行cd命令切换到该路径。例如你创建的项目名为demo-app，存放在D:\workspace路径下，就执行：

   cd D:\workspace\demo-app
   

3. 切换路径后，执行dir（Windows）或ls（Mac/Linux）确认当前目录下存在angular.json、package.json两个核心文件，再重新执行启动命令即可：

   ng serve --open
   

如果切换到正确路径后仍然报错，按以下优先级排查：

• 检查项目创建流程是否完整：如果之前执行ng new时中途断网、手动终止了进程，会导致angular.json文件未生成或内容残缺，这种情况直接删除残缺的项目文件夹，重新执行ng new <项目名>走完完整创建流程即可
• 检查全局Angular CLI和项目版本兼容性：执行ng version查看全局CLI版本，如果全局CLI主版本和项目依赖的Angular主版本差超过2个大版本（比如全局是Angular 17，项目是Angular 12），先在项目根目录执行npm install安装项目本地依赖的CLI版本，再用npx ng serve --open启动，就会自动调用项目本地匹配版本的CLI执行命令

不要从其他Angular项目复制angular.json文件到当前目录凑数，该文件存储了当前项目的构建配置、资源路径、入口文件等专属配置，复制外部文件会触发更多不可预期的构建错误。

内容的提问来源于stack exchange，提问作者Onur Ata Asar