如何在Azure DevOps中执行'ng build'解决ng命令不存在报错

报错的核心原因 #

你遇到的ng命令不存在问题，核心原因是：Angular CLI默认是作为项目本地依赖安装在node_modules目录下的，并没有全局安装在Azure DevOps代理机器的系统PATH中。直接在通用命令行任务中调用ng build时，系统只会检索全局PATH路径，找不到本地安装的CLI可执行文件，因此触发报错。

基于内置任务的正确实现步骤 #

• 先确保前置依赖任务配置正确
  使用内置npm任务执行依赖安装，无论用npm ci还是npm install，都要将任务的工作目录配置为Angular项目的根目录（即包含package.json、angular.json文件的目录），保证依赖完整安装到项目对应的node_modules路径下。
• 根据使用场景选择对应的内置任务执行构建，无需全局安装Angular CLI
  • 推荐方案：使用内置npm任务执行npm脚本
    这个方式完全不用手动处理CLI路径问题：npm在执行自定义脚本时，会自动将项目本地node_modules/.bin目录加入临时检索路径，直接调用本地安装的Angular CLI。只要你项目的package.json中原本存在build脚本（默认就是ng build相关命令），就可以将npm任务的执行类型切换为Execute npm script，脚本名填写build即可完成构建。
  • 替代方案：使用通用命令行任务执行构建
    如果习惯用命令行任务，不要直接写ng build，改为执行以下任意一种兼容命令，避免全局检索的问题：
    • 用内置的npx工具调用：npx ng build，npx会自动定位项目本地安装的@angular/cli包，跨Windows、Linux代理都能兼容
    • 直接指定本地CLI的相对路径：对应Linux/macOS代理写./node_modules/.bin/ng build，Windows代理写.\node_modules\.bin\ng.cmd build
• 常见配置避坑
  • 不要尝试通过全局安装Angular CLI的方式解决问题，这种方式容易因为代理环境快照版本不一致、全局CLI和项目要求的CLI版本不匹配引发新的构建报错，不符合内置任务的无状态设计逻辑
  • 所有和构建相关的任务，要保持工作目录完全和依赖安装任务一致，避免因路径错位导致找不到本地依赖

注意：整个流程不需要手动配置系统PATH环境变量，所有路径的检索逻辑都会由内置任务自动处理。

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