Azure DevOps流水线执行msbuild /t:Metrics失败，提示目标不存在

问题现象 #

本地命令行执行以下MSBuild命令可正常运行：

"C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\MSBuild\15.0\Bin\msbuild.exe" test.sln /t:Metrics -p:Configuration=Debug -p:Platform="Any CPU"

但在Azure DevOps流水线中，无论是使用CmdLine@2任务：

- task: CmdLine@2
  inputs:
    script: '"C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\MSBuild\15.0\Bin\msbuild.exe" Test.sln /p:AzureDevOps=true /verbosity:d /t:Metrics -p:Configuration=Debug -p:Platform="Any CPU"'
    workingDirectory: 'C:\a\1\s\Ett\Test'
    failOnStderr: true

还是VSBuild@1任务：

- task: VSBuild@1
  displayName: CodeMetrics    
  inputs:
   solution: '**\CN.Test.sln'
   msbuildArgs: '/t:Metrics'      
   platform: 'Any CPU'
   configuration: 'debug'
   createLogFile: true
   logFileVerbosity: 'detailed'

执行时均报错：“目标‘Metrics’在项目中不存在”

可能原因 #

1. 本地环境安装了包含Metrics目标的扩展工具（如代码度量相关的MSBuild扩展包），但Azure DevOps代理机器未安装对应组件。
2. VSBuild@1任务默认使用的MSBuild环境与本地不一致，缺少Metrics目标的定义文件。
3. 流水线中指定的解决方案路径（**\CN.Test.sln）与本地的test.sln并非同一项目，或者目标项目未定义Metrics构建目标。

解决办法 #

• 检查代理机器的工具配置：确保Azure DevOps代理安装了和本地一致的Visual Studio 2017 Professional版本，以及代码度量相关组件。可在流水线中添加PowerShell任务，执行msbuild /version确认MSBuild版本，同时检查MSBuild扩展目录下是否存在Metrics相关的.targets文件。
• 统一MSBuild环境与参数：使用CmdLine任务时，确保调用的MSBuild路径和本地完全一致；若Metrics目标来自自定义扩展，可通过/p:MSBuildExtensionsPath参数指定扩展所在路径，或在项目文件中显式导入对应的.targets文件（需确保该文件已提交到代码库）。
• 核对项目与解决方案配置：确认流水线中选中的解决方案和本地构建的是同一个项目，打开项目文件检查是否包含类似<Import Project="xxx.Metrics.targets" />的导入语句，确保该目标文件存在于代码库中。
• 替换为专用流水线任务：Azure DevOps市场提供现成的代码度量任务，可替代自定义的Metrics构建目标，避免环境依赖问题。

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