如何在Azure Pipeline中设置C#条件编译符号并运行MSBuild？

核心实现逻辑 #

Azure Pipeline的MSBuild@1任务没有专门的conditionalCompilationSymbol输入项，但可以通过MSBuild原生的DefineConstants参数直接传递条件编译符号，这是最直接且高效的方案。

1. 直接在YAML中固定配置符号

修改现有MSBuild任务的msbuildArguments，添加/p:DefineConstants参数来指定符号的true/false状态：

- task: MSBuild@1
  displayName: 'Build solution'
  inputs:
    solution: 'X.csproj'
    platform: 'AnyCPU'
    configuration: 'Release'
    msbuildArguments: '/target:Publish /p:DefineConstants="SYMBOL=true"'
    clean: true
    enabled: true

• 多符号配置用分号分隔：/p:DefineConstants="SYMBOL=true;ANOTHER_SYMBOL=false"
• 若项目已有默认编译符号（如TRACE、RELEASE），需一并保留避免覆盖：/p:DefineConstants="TRACE;RELEASE;SYMBOL=true"

2. 通过Pipeline变量动态控制符号

如果需要根据分支、环境等场景灵活切换符号状态，可先定义Pipeline变量，再在MSBuild参数中引用：

首先在YAML头部或Pipeline界面配置变量：

variables:
  ConditionalSymbols: 'SYMBOL=true'

然后修改MSBuild任务：

- task: MSBuild@1
  displayName: 'Build solution'
  inputs:
    solution: 'X.csproj'
    platform: 'AnyCPU'
    configuration: 'Release'
    msbuildArguments: '/target:Publish /p:DefineConstants="$(ConditionalSymbols)"'
    clean: true
    enabled: true

这种方式支持触发Pipeline时手动修改变量值，或通过变量组、分支策略动态赋值。

3. 配合项目文件配置增强灵活性

若要保留项目默认编译符号的同时动态扩展，可在C#项目文件（X.csproj）中预先配置默认值，再通过MSBuild参数覆盖或追加：
在csproj中添加：

<PropertyGroup>
  <DefineConstants>TRACE;RELEASE</DefineConstants>
</PropertyGroup>

之后在Pipeline的MSBuild参数中追加符号：

msbuildArguments: '/target:Publish /p:DefineConstants="$(DefineConstants);SYMBOL=true"'

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