如何在Azure Pipeline中确保dotnet tool安装成功不报错

Azure DevOps流水线中执行dotnet tool install dotnet-project-licenses -g全局安装许可证扫描工具时，首次在全新代理运行可正常执行，若代理已安装过该工具，命令会返回非0退出码，直接导致流水线任务失败。这是dotnet tool指令的默认行为，并非流水线配置错误。

按需选择以下任意一种方案即可解决问题：

方案1：用update命令替代install（最简便，优先选） #

直接把原安装命令替换为dotnet tool update，这个命令原生兼容两种场景：

• 代理未装目标工具：自动安装最新稳定版
• 代理已装旧版本：自动升级到最新稳定版
  全程不会触发"工具已存在"类报错，不需要额外写判断逻辑，维护成本最低。

对应流水线任务配置：

- task: CmdLine@2
  displayName: 'Install dotnet-project-licenses'
  inputs:
    script: 'dotnet tool update dotnet-project-licenses -g'

如果不希望流水线每次运行都自动升级工具版本，只想保留首次安装的固定版本，选下面的判断式安装方案。

方案2：预检查安装状态，仅未安装时执行安装 #

安装前先检测当前代理是否已经存在该工具，只有检测不到时才执行安装命令，从根源上避免重复执行install指令。

• 如果代理池是Windows环境，用以下配置：

- task: CmdLine@2
  displayName: 'Install dotnet-project-licenses'
  inputs:
    script: |
      dotnet tool list -g | findstr /i dotnet-project-licenses > nul
      if %errorlevel% neq 0 (
        dotnet tool install dotnet-project-licenses -g
      )

• 如果代理池是Linux/macOS环境，把脚本替换为shell兼容版本即可：

- task: CmdLine@2
  displayName: 'Install dotnet-project-licenses'
  inputs:
    script: |
      dotnet tool list -g | grep -i dotnet-project-licenses > /dev/null
      if [ $? -ne 0 ]; then
        dotnet tool install dotnet-project-licenses -g
      fi

避坑提醒 #

不要直接给原任务加continueOnError: true强行忽略所有错误，这种写法会把网络异常、权限不足、SDK版本不兼容等真正导致安装失败的问题也一并屏蔽，后续执行许可证扫描时会随机出现找不到工具的报错，排查成本极高。

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