在C#的开发体系中，#if DEBUG是一条条件编译指令，它的作用是让编译器根据当前是否定义了DEBUG这个编译符号，来决定是否编译特定的代码块。简单来说，当DEBUG符号存在时，#if DEBUG和对应的#endif之间的代码会被编译器处理，否则这部分代码会被直接忽略，不会出现在最终生成的程序集中。
#if DEBUG 的基本原理
C#的编译过程支持条件编译，开发者可以通过定义不同的编译符号，控制不同代码块的编译状态。DEBUG是一个默认的编译符号，当你使用调试模式（Debug配置）构建项目时，Visual Studio或者dotnet命令行工具会自动定义这个符号。而当你切换到发布模式（Release配置）构建时，默认不会定义DEBUG符号，因此#if DEBUG包裹的代码就不会被编译进去。
默认配置下的DEBUG符号状态
我们可以通过一个简单的表格来查看不同构建配置下DEBUG符号的默认情况：
| 构建配置 | DEBUG符号是否定义 | #if DEBUG代码块是否编译 |
|---|---|---|
| Debug | 是 | 是 |
| Release | 否 | 否 |
如何在C#中使用 #if DEBUG
使用#if DEBUG的语法非常简单，只需要用#if DEBUG标记代码块的开始，用#endif标记代码块的结束即可。中间可以放置任意合法的C#代码，这些代码只会在DEBUG符号被定义的时候才会被编译。
基础使用示例
最常见的使用场景是放置调试相关的日志输出、测试数据生成等逻辑，避免这些代码出现在生产环境中。下面是一个简单的示例：
using System;
namespace DebugDemo
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("这是正式环境的逻辑代码");
#if DEBUG
// 以下代码只在调试模式下编译执行
Console.WriteLine("这是调试模式的日志，不会出现在发布版本中");
int testValue = 100;
Console.WriteLine($"调试测试值：{testValue}");
#endif
Console.WriteLine("程序执行结束");
}
}
}
当你用Debug配置运行这个程序时，会输出三行内容，包括调试日志。如果用Release配置运行，调试相关的两行输出不会出现，因为对应的代码没有被编译。
配合#else和#elif使用
#if DEBUG还可以配合#else和#elif指令使用，实现不同编译符号下的不同逻辑。比如我们可以同时处理DEBUG和RELEASE两种配置的不同逻辑：
using System;
namespace DebugDemo
{
class Program
{
static void Main(string[] args)
{
#if DEBUG
Console.WriteLine("当前是调试模式，开启详细日志");
#elif RELEASE
Console.WriteLine("当前是发布模式，关闭详细日志");
#else
Console.WriteLine("未知构建配置");
#endif
}
}
}
手动控制DEBUG符号
除了使用默认的构建配置，我们也可以手动控制DEBUG符号的定义。如果是使用dotnet命令行构建项目，可以通过-p:DefineConstants参数来添加编译符号：
# 手动定义DEBUG符号构建项目 dotnet build -p:DefineConstants=DEBUG
如果是在项目文件中配置，可以在.csproj文件的PropertyGroup节点下添加DefineConstants属性：
<PropertyGroup> <DefineConstants>DEBUG;MY_CUSTOM_SYMBOL</DefineConstants> </PropertyGroup>
这样配置后，无论使用什么构建配置，DEBUG符号都会被定义，#if DEBUG包裹的代码都会被编译。
使用注意事项
- #if DEBUG只能控制代码的编译，不能控制运行时的逻辑判断，被忽略的代码不会出现在最终的程序集中，因此不会占用运行时的资源。
- 不要在#if DEBUG包裹的代码中定义只在调试时使用的公共类型或者公共方法，否则如果其他代码引用了这些类型或方法，切换到Release模式时会出现编译错误。
- 条件编译指令是编译阶段的特性，和运行时的条件判断（比如if语句）不同，不要混淆两者的使用场景。
- 如果需要在调试时和发布时使用不同的常量值，也可以使用条件编译来定义，比如：
#if DEBUG
const string ApiUrl = "http://192.168.0.1:8080/api";
#else
const string ApiUrl = "https://ipipp.com/api";
#endif
这样调试时使用本地测试接口，发布时自动切换到正式接口，不需要手动修改代码。