在C#项目里，我们经常需要让同一份源代码在不同构建配置下表现出不同行为，例如开发阶段打印调试信息，而正式发布时完全去掉这些逻辑。条件编译就是专门在编译阶段控制代码是否参与编译的技术，它不会把无用分支带进最终程序集。
一、使用#if等预处理指令实现条件编译
C#支持一系列预处理指令，最常用的是#if、#elif、#else和#endif。这些指令根据是否定义了某个编译符号，决定其包裹的代码块是否被编译器接纳。编译符号可以通过项目属性中的“定义常量”设置，也可以在代码文件顶部用#define临时定义。
需要注意的是，#define必须放在文件最前面，且它定义的符号仅对当前文件有效。系统自带的符号如DEBUG和TRACE，在Visual Studio的Debug配置下自动定义，Release配置默认不定义DEBUG。我们可以利用这一点区分环境。
#define MY_FEATURE // 仅当前文件生效，一般少用
using System;
class Program
{
static void Main()
{
#if DEBUG
Console.WriteLine("调试模式：输出详细日志");
#elif RELEASE
Console.WriteLine("发布模式：仅核心信息");
#else
Console.WriteLine("其他配置");
#endif
#if MY_FEATURE
Console.WriteLine("自定义功能已开启");
#endif
}
}
上面代码在Debug模式下会编译第一句输出，在Release下编译第二句。如果项目全局定义了MY_FEATURE（通过在.csproj里设置<DefineConstants>），则最后一段也会编译进去。这种方式的优点是直观、能圈定任意代码块，缺点是用得太多会让文件可读性下降。
从编译结果看，未被选中的分支根本不会生成IL指令，因此不会产生运行时判断开销，也减小了程序集体积。但过多散落的#if会让维护者难以一眼看清主流程，建议只用来隔离大块环境相关逻辑。
二、使用Conditional特性进行方法级条件编译
除了预处理指令，.NET还提供了System.Diagnostics.ConditionalAttribute。把它加在方法上，并指定一个编译符号，那么所有对该方法的调用，都会在对应符号未定义时被编译器直接移除，而不是方法体内部被移除。
这意味着方法本身若未被调用则无所谓，关键在于“调用点”是否保留。它比#if包裹调用代码更优雅，因为方法定义处不用写条件指令，调用处也不用写，干净很多。
using System;
using System.Diagnostics;
class Logger
{
[Conditional("DEBUG")]
public static void LogDebug(string msg)
{
Console.WriteLine("[DEBUG] " + msg);
}
[Conditional("TRACE")]
public static void LogTrace(string msg)
{
Console.WriteLine("[TRACE] " + msg);
}
}
class Program
{
static void Main()
{
Logger.LogDebug("开始执行");
Logger.LogTrace("步骤一");
Console.WriteLine("正常业务");
}
}
在Debug配置下，LogDebug和LogTrace的调用都会保留；切到Release（未定义TRACE时），LogTrace调用行直接从编译结果里消失，就像从来没写过。注意Conditional只能用于返回void的方法，且不能用于重写方法或实现接口的方法，否则编译报错。
相比#if，Conditional让调用方代码非常整洁，也避免了忘记写#endif导致语法错误的问题。它适合做日志、断言、性能计数等辅助功能。缺点是不能条件编译属性或代码块中的局部逻辑，只能作用于整个方法调用。
三、两种方式对比与项目配置建议
为了更清楚地选择，我们把两者差异整理成表格：
| 对比项 | #if预处理指令 | Conditional特性 |
|---|---|---|
| 作用范围 | 任意代码块 | 方法级调用 |
| 代码整洁度 | 较低，易碎片化 | 较高，调用处无痕迹 |
| 适用场景 | 大段环境差异逻辑 | 辅助方法如日志断言 |
| 限制 | 需注意配对和可读性 | 仅void方法，不能重写 |
在实际项目中，推荐用项目文件统一定义符号。例如在.csproj里写<DefineConstants>MY_FEATURE;OTHER</DefineConstants>，这样整个工程都能识别这些符号，而不必每个文件写#define。
对于日常调试输出，优先使用[Conditional("DEBUG")]封装日志类；只有当你需要整段替换算法实现或引用不同程序集时，才使用#if。混合使用并无不可，但要保持团队规范，避免同一个符号在多处含义不同。
四、常见误区与注意事项
有人以为条件编译和运行时if判断差不多，其实完全不同。运行时的if (DEBUG)即使DEBUG为false，判断语句和字符串等还可能留在程序集里，而条件编译在编译期就剔除了。另外，Conditional标注的方法若在非DEBUG下仍被反射调用，方法体本身还在程序集中，只是普通调用没了。
还需小心符号大小写，C#编译符号区分大小写，DEBUG和debug不是同一个。以及在ASP.NET Core中，环境变量控制的是托管配置，不等于编译符号，不要混淆。正确使用条件编译，可让多环境构建既安全又轻量。
C#条件编译Conditional修改时间：2026-08-05 11:15:50