如何正确使用PublishPipelineArtifact@1指定特定文件夹发布构建产物？

我来帮你排查这个诡异的问题——明明指定了路径却发布了整个工作目录的内容，大概率是几个容易忽略的细节出了问题，咱们一步步解决：

1. 先确认目标路径是否真的存在 #

最常见的原因是你指定的pathToPublish路径不存在，这时PublishPipelineArtifact@1任务会默认回退到发布整个工作目录。咱们先加个验证任务，确认路径和内容：

- task: PowerShell@2
  displayName: 'Verify Target Publish Path'
  inputs:
    targetType: 'inline'
    script: |
      $targetDir = "$(System.DefaultWorkingDirectory)/s/ReportProject/bin/Release/netcoreapp3.1"
      Write-Host "Checking target directory: $targetDir"
      
      if (Test-Path $targetDir) {
          Write-Host "✅ Path exists! Here's what's inside:"
          Get-ChildItem $targetDir -Recurse | Format-Table FullName, Length
      } else {
          Write-Host "❌ ERROR: Target path does NOT exist!"
          Write-Host "Current working directory contents:"
          Get-ChildItem $(System.DefaultWorkingDirectory) -Recurse | Format-Table FullName, Length
      }

运行这个任务后，你就能清楚看到目标路径是否存在，以及里面有没有你要发布的产物。如果路径不存在，那你得先修正构建脚本的输出目录，确保产物生成到正确的位置。

2. 检查变量替换是否符合预期 #

有时候$(System.DefaultWorkingDirectory)的值可能和你预期的不一样，比如流水线的工作目录结构有变化。你可以在上面的验证脚本里加一行，打印这个变量的实际值：

Write-Host "System.DefaultWorkingDirectory value: $(System.DefaultWorkingDirectory)"

确认这个根路径和你项目的实际位置匹配。

3. 修正发布任务的配置 #

确认路径没问题后，再调整发布任务的配置，建议给路径加上引号（避免路径里有空格或特殊字符时出问题），同时可以明确指定publishLocation为Container（虽然是默认值，但显式指定更稳妥）：

- task: PublishPipelineArtifact@1
  displayName: Publish Report
  inputs:
    pathToPublish: '$(System.DefaultWorkingDirectory)/s/ReportProject/bin/Release/netcoreapp3.1'
    artifactName: 'MyReport'
    publishLocation: 'Container'
    # 可选：如果只想发布特定类型的文件，比如过滤掉临时文件，可以加contents参数
    # contents: '**/*.dll'
    # contents: '**/*.html'

4. 排查是否有其他发布任务干扰 #

检查你的流水线里是否还有其他PublishPipelineArtifact或者PublishBuildArtifacts任务，有时候多个发布任务会导致你误以为当前任务发布了全部内容——其实可能是另一个任务发布了整个目录。

按照这个流程排查，应该能快速定位到问题所在。如果验证后发现路径确实存在但还是发布全部内容，那可以看看流水线的日志，搜索PublishPipelineArtifact任务的执行细节，里面会明确显示它实际发布的路径是什么，根据日志再进一步排查。

内容的提问来源于stack exchange，提问作者MrD at KookerellaLtd