什么是 #define
和 #if
，它们真能控制编译？
能。C# 的条件编译指令不是运行时判断，而是在编译阶段就决定哪些代码进最终程序集、哪些直接被剔除——连语法检查都不走。这意味着：
#if DEBUG块里的错误代码，只要没启用
DEBUG符号，编译器根本不会报错。
关键点：这些指令只影响编译结果，不产生任何运行时开销；但一旦符号未定义，对应代码块就彻底消失，调试器也看不到。
#define
必须放在文件最前面，且不能带分号
#define是预处理器指令，不是语句，所以它不能出现在命名空间、类、方法内部，也不能加
;。常见错误是把它写在
using之后或类里面，会导致编译失败：
// ❌ 错误：位置不对 + 多了分号
using System;
#define LOGGING; // 编译错误：Unexpected preprocessor directive
<p>class Program {</p><h1>define FEATURE_X // 编译错误：not allowed inside a class</h1><p>正确写法（必须是文件顶部，且无分号）：
#define DEBUG
#define LOGGING
using System;
<p>class Program { ... }
#define只对当前文件生效（除非用
/define编译器参数全局定义） 不能用
=赋值，比如
#define VERSION=2.0是非法的；它只定义“存在性” 若需多值开关，推荐用多个独立符号（
#define USE_CACHE、
#define MOCK_NETWORK），而非尝试模拟枚举
#if
、#elif
、#else
、#endif
的嵌套与逻辑组合
这些指令支持嵌套和布尔运算符
||、
&&、
!，但注意：运算符优先级固定，且不支持括号分组（C# 预处理器不解析括号）。
常见误用：
#if DEBUG && !RELEASE // ✅ 合法
#if (DEBUG && !RELEASE) // ❌ 编译错误：unexpected '('
#if DEBUG || TEST_MODE && LOGGING // ✅ 但实际等价于 DEBUG || (TEST_MODE && LOGGING)
想表达 “DEBUG 为真，且（TEST_MODE 或 LOGGING）为真”，必须拆成两层 #if
#elif不是
else if的简写，它只是“否则如果另一个符号成立”，不继承前一个条件的否定逻辑 未配对的
#endif会导致后续所有代码被跳过，极难排查——建议编辑器开启预处理指令高亮
如何在项目中安全地定义和管理条件编译符号？
手动在每个文件顶上写
#define维护成本高、易遗漏。更可靠的方式是通过项目配置统一管理： Visual Studio：项目属性 → “生成” → “常规” → “条件编译符号” 输入框，填入
DEBUG;TRACE;MY_FEATURE（用分号分隔） .csproj 文件中添加：
<PropertyGroup> <DefineConstants>DEBUG;TRACE;ENABLE_LOGGING</DefineConstants> </PropertyGroup>MSBuild 命令行：
dotnet build /p:DefineConstants="DEBUG;UNIT_TEST"
注意：
DEBUG和
TRACE是 Visual Studio 默认为 Debug 配置自动添加的，Release 配置默认不包含
DEBUG——但
TRACE通常仍保留，这点容易被忽略。
复杂项目里，不同环境（dev/staging/prod）可能需要不同符号组合，建议用 MSBuild 的
Condition属性做条件注入，而不是硬编码在源码里。
