Azure Pipeline无法在我的环境中运行简单Angular构建

常见问题解决办法 #

• Node.js版本不匹配
  Angular各版本对Node.js有明确要求，比如Angular 16需Node.js 16.14+或18.x版本。在Azure Pipeline中要指定对应版本：

  - task: NodeTool@0
    inputs:
      versionSpec: '18.x'
    displayName: '安装Node.js'
  

• Angular CLI未安装/版本不符
  构建前必须安装项目对应版本的Angular CLI，可选两种方式：
  全局安装指定版本：

  npm install -g @angular/cli@你的项目CLI版本号
  

  或使用项目本地CLI执行构建：

  npx ng build
  

• 依赖安装失败
  若npm install报错，先清理缓存再重新安装：

  npm cache clean --force
  npm install
  

  也可以用npm ci替代npm install，能严格按照package-lock.json中的版本安装，避免版本不一致问题。

• 构建命令参数错误
  生产环境构建命令注意版本差异：Angular 14及以前用--prod，15及以后需用--configuration production：

  ng build --configuration production
  

• 权限不足
  使用Linux/macOS代理构建时若遇权限错误，可临时修改npm配置：

  npm config set unsafe-perm true
  

  （优先调整代理权限，尽量避免使用sudo）

额外排查技巧 #

要是上面的方法都没解决问题，就在Pipeline中添加详细日志输出，定位具体错误点：

npm install --verbose
ng build --verbose

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