Angular CLI非工作区运行命令不可用致CI构建失败排查

This command is not available when running the Angular CLI outside a workspace 报错的触发条件非常明确：执行ng相关命令时，Angular CLI在当前工作目录下没有找到angular.json工作区配置文件，判定当前路径不属于有效的Angular项目，直接拦截命令执行。
结合你贴的CI配置，按以下顺序排查修复即可：

• 优先确认CI执行时的工作目录是否正确
  你使用的是打了A-runner标签的自定义执行器，这类Runner经常出现默认工作目录配置错误、代码拉取步骤缺失的问题。直接在script段最开头加上pwd、ls -la两行命令打运行日志，确认执行命令的当前目录下是否存在angular.json、package.json两个核心文件。如果目录不对，要么追加cd 你的Angular项目实际根目录命令切换路径，要么检查Runner的工作目录配置、CI流水线的代码拉取（checkout）逻辑是否正常。
• 修正Angular CLI的安装与调用逻辑
  你当前配置里的CLI安装逻辑存在兼容性问题：
  1. 不需要执行npm link @angular/cli做全局关联，全局link的CLI版本如果和项目本地依赖的Angular版本不匹配，会直接导致工作区识别失败。
  2. 不要单独安装@angular/cli@latest，latest版本的CLI如果和你项目使用的Angular大版本不兼容，同样会出现识别不到工作区的问题。正确做法是先执行npm ci（优先用这个命令，会严格按照lock文件安装依赖，稳定性远高于npm install）安装项目package.json里声明的所有依赖（包括项目本地匹配版本的Angular CLI），后续用npx ng build调用CLI即可，npx会优先使用项目本地安装的匹配版本CLI，不会出现版本冲突问题。
• 核对build命令的项目名参数
  你写的ng build Angularjs里的项目名，必须和angular.json文件中projects字段下声明的项目名完全一致（注意大小写敏感），部分版本的Angular CLI在找不到对应项目时，也会抛出“不在工作区”的误导性报错。
• 核对构建产物路径
  你当前配置里收集产物的路径是./public，需要和angular.json里配置的outputPath字段保持一致，默认Angular项目的构建输出路径是dist/你的项目名，如果路径写错就算构建成功也收集不到产物。

stages:
  - build
# 不要直接用node:latest镜像，选择和你项目Angular版本匹配的Node LTS版本，比如Angular 14+推荐用Node 18
image: node:18
angular-build:
  tags:
    - A-runner
  stage: build
  script:
    - pwd
    - ls -la
    # 如果日志显示当前目录不是项目根，解开下面这行注释，改成实际的项目目录名
    # - cd ./your-angular-project-root
    - npm ci
    # 项目名和angular.json里保持一致，生产构建建议加--configuration production参数
    - npx ng build your-project-name --configuration production
  artifacts:
    paths:
      # 改成angular.json里配置的实际输出路径
      - dist/your-project-name

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