Azure Pipeline预处理器指令未生效，单元测试始终失败求助

问题描述 #

在Azure Pipelines搭建构建流水线时，目标分支有提交时自动构建解决方案并运行单元测试。代码中用预处理器指令#if AZURE_PIPELINE判断是否在流水线环境，但本该跳过的代码始终执行。

排查用的单元测试代码：

[Fact]
public void PipelineTest()
{
#if AZURE_PIPELINE

    // Return immediately when in the pipeline
    return;

#endif

    // Intentionally fail when not in the pipeline
    true.Should().BeFalse();
}

流水线YAML配置：

trigger:
- develop

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'
  
workspace:
  clean: 'all'

steps:
# Restore and Build the solution
- task: DotNetCoreCLI@2
  displayName: 'Build Solution'
  inputs:
    command: 'build'
    projects: '$(solution)'
    arguments: '/m'

# Run unit tests
- task: DotNetCoreCLI@2
  displayName: 'Run Unit Tests'
  inputs:
    command: 'test'
    projects: '$(solution)'

尝试过两种设置方式：

1. 在build任务参数中添加/p:DefineConstants=AZURE_PIPELINE
2. 在build和test任务中通过env字段设置环境变量
   但测试始终失败，询问遗漏了什么，是否误解了预处理器指令或流水线变量逻辑。

问题分析与解决 #

核心误区：预处理器指令和环境变量无关 #

C#的#if预处理器指令是编译阶段生效的，它只认编译时传入的常量定义，和你用env设置的运行时环境变量完全不搭边——这就是环境变量方式完全无效的原因。

DefineConstants设置的两个关键错误 #

你尝试在build任务加/p:DefineConstants=AZURE_PIPELINE的方向是对的，但踩了两个坑：

1. 覆盖了默认常量：直接赋值会把项目原本的常量（比如Release模式下的RELEASE、TRACE）冲掉，正确的做法是追加：/p:DefineConstants="$(DefineConstants);AZURE_PIPELINE"，保留原有常量的同时新增自定义常量。
2. test任务会重新构建：DotNetCoreCLI@2的test命令默认会重新编译测试项目，如果test任务没传同样的常量参数，之前build阶段设置的常量会丢失，导致预处理器指令不生效。

修正后的流水线配置 #

给build和test任务都加上正确的常量参数，或者在test任务里禁用自动构建（前提是build阶段已经编译好所有测试项目）：

trigger:
- develop

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'
  
workspace:
  clean: 'all'

steps:
- task: DotNetCoreCLI@2
  displayName: 'Build Solution'
  inputs:
    command: 'build'
    projects: '$(solution)'
    arguments: '/m /p:DefineConstants="$(DefineConstants);AZURE_PIPELINE"'

- task: DotNetCoreCLI@2
  displayName: 'Run Unit Tests'
  inputs:
    command: 'test'
    projects: '$(solution)'
    # 方案1：传递相同的常量参数，允许重新构建
    arguments: '/p:DefineConstants="$(DefineConstants);AZURE_PIPELINE"'
    # 方案2：禁用重新构建，直接用build阶段的产物（更高效）
    # arguments: '--no-build'

验证常量是否生效的小技巧 #

如果还是不确定常量有没有被正确定义，可以在测试方法里加一行代码输出当前编译的常量：

[Fact]
public void PipelineTest()
{
    var constants = typeof(object).Assembly.GetCustomAttributes<AssemblyDefineConstantsAttribute>()
        .SelectMany(a => a.Constants.Split(';'));
    Console.WriteLine($"Defined constants: {string.Join(", ", constants)}");

#if AZURE_PIPELINE
    return;
#endif
    true.Should().BeFalse();
}

运行测试后查看日志，就能看到AZURE_PIPELINE是否出现在常量列表里。

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