Azure Pipelines Tasks中DotNetCoreCLI任务参数引号处理问题解析

问题背景

在使用Azure Pipelines的DotNetCoreCLI任务执行dotnet publish命令时，开发人员遇到了一个关于参数引号处理的特殊问题。当尝试通过ContainerImageTags参数传递多个容器标签时，系统对引号的处理方式导致了标签列表被错误解析。

问题现象

开发人员最初尝试使用以下YAML配置：

- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: false    
    projects: |
       .... my projects ...
    arguments: -p ContainerImageTags="'\"latest;dev;$(tag);$(buildnum)\"'" -p:PublishProfile="mespressen"

虽然这个命令在本地命令行中可以正常工作，但在Azure Pipelines中运行时出现了以下问题：

1. 部分标签被意外移除
2. 标签分隔符从分号被错误地替换为逗号
3. 最终导致构建失败，错误提示"Invalid ContainerImageTags provided"

技术分析

这个问题本质上源于Azure Pipelines任务对命令行参数的特殊处理机制。DotNetCoreCLI任务在执行时会对参数进行额外的解析和转义处理，这导致了多层引号的意外变化。

在容器化构建场景中，ContainerImageTags参数需要保持特定的引号格式才能被正确解析。微软官方文档中提到的单引号用法在直接命令行中有效，但在经过Azure Pipelines任务处理后会产生不符合预期的结果。

解决方案

经过验证，正确的参数格式应该是使用转义的双引号而非单引号组合：

- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: false    
    projects: |
       .... my projects ...
    arguments: -p ContainerImageTags="\"latest;dev;$(tag);$(buildnum)\"" -p:PublishProfile="mespressen"

这种写法确保了：

1. 参数值被双引号包裹
2. 内部的分号分隔符被保留
3. 所有标签都能被正确传递
4. 符合dotnet publish命令的参数解析要求

最佳实践建议

1. 在Azure Pipelines中使用复杂参数时，建议先在本地验证命令行格式
2. 对于包含特殊字符的参数值，使用转义字符而非多层引号组合
3. 当遇到参数解析问题时，可以启用系统调试模式查看实际执行的命令
4. 对于容器相关参数，特别注意分隔符和引号的正确使用方式

总结

这个案例展示了在CI/CD流水线中参数传递的复杂性。Azure Pipelines任务会对参数进行额外处理，这有时会导致与本地命令行行为的差异。理解这种差异并掌握正确的参数转义方法，是确保构建流程稳定运行的关键。对于dotnet publish命令的容器相关参数，使用转义双引号是最可靠的解决方案。