Conditional特性根据编译符号决定是否编译void方法调用,如[Conditional("DEBUG")]使Log仅在定义DEBUG时生效;支持多条件叠加,彻底移除未满足条件的调用以避免运行时开销。

Conditional特性用于根据编译符号(如 DEBUG、TRACE 等)来决定是否编译某个方法调用。它常用于控制调试或日志代码的执行,只在特定编译条件下包含这些代码。
作用机制
给方法加上 [Conditional("DEBUG")] 后,该方法的调用将只在定义了对应符号(例如 DEBUG)时才会被编译进最终程序集。如果没有定义,则调用会被完全移除,相当于没有这行代码。
注意:Conditional 特性只能应用于返回类型为 void 的方法。
常见用途
- 调试输出:只在 DEBUG 模式下调用打印日志
- 性能追踪:在特定条件下启用性能监控
- 断言检查:实现自定义的 Assert 方法
#define DEBUG
using System;
using System.Diagnostics;
class Program
{
[Conditional("DEBUG")]
public static void Log(string message)
{
Console.WriteLine("[LOG] " + message);
}
static void Main()
{
Log("程序开始"); // 只有在定义 DEBUG 时才执行
DoWork();
Log("程序结束");
}
static void DoWork() { }
}
如果去掉 #define DEBUG,所有 Log 调用都会被编译器自动移除,不会产生任何调用开销。
多个条件控制
可以使用多个 Conditional 特性,表示方法在任一符号被定义时都应编译:
[Conditional("DEBUG")]
[Conditional("TRACE_LOG")]
public static void TraceLog(string msg)
{
Console.WriteLine("[TRACE] " + msg);
}
只要定义了 DEBUG 或 TRACE_LOG,调用就会保留。
基本上就这些。这个特性帮你写出更干净、无运行时判断开销的条件执行代码。








