C#中预处理器指令的用法_C#条件编译和DEBUG指令教程【基础】-C#.Net教程-PHP中文网

预处理器指令是编译前的文本筛选，不满足条件的代码块不会进入语法分析、不生成il；#define必须位于文件最顶部、无分号、仅限当前文件；#if剔除代码而非运行时跳过；#error/#warning在编译解析阶段触发；#nullable直接影响类型系统。

c#中预处理器指令的用法_c#条件编译和debug指令教程【基础】

预处理器指令不是运行时逻辑，而是编译前的文本筛选——不满足条件的代码块根本不会进入语法分析，也不会生成任何 IL。

很多新手在类内部或 using 语句之后写 #define DEBUG，结果编译器直接忽略它，#if DEBUG 始终为 false。这是因为 #define 必须是源文件中第一个非空白、非注释的语句（在 using 之前），且整行只能有该指令，不能加分号或跟其他内容。

#define 只对当前文件生效，无法跨文件传播；全局符号应通过项目属性（Build → Conditional compilation symbols）或 MSBuild 的 DefineConstants 设置
不要用 #define VERSION "1.2" 这类“带值宏”——C# 不支持，会编译失败；需要常量请用 const string Version = "1.2";
定义后不能用 typeof(DEBUG) 或 DEBUG.ToString()，它只是个编译期开关，不是变量

写 #if DEBUG 和写 if (DEBUG) 完全是两回事：#if 块内代码若未满足条件，连语法检查都不会走，更不会占用方法表或 JIT 时间；而后者哪怕恒为 false，也得编译进 IL，还可能触发优化警告。

Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载

嵌套超过两层就容易出错，比如 #if NET6_0 #if ENABLE_LOGGING ... #endif #endif，建议合并为单层：#if NET6_0 && ENABLE_LOGGING
避免否定式判断，如 #if !DISABLE_CACHE；改成正向定义 #if ENABLE_CACHE，否则后续加新分支时极易漏掉取反
被剔除的代码仍可保留注释说明用途，例如：// #if DEBUG: only for local diagnostics, excluded in release

#error 和 #warning 不是日志输出，它们在编译解析阶段就触发，能立刻阻断构建流程或发出提示。适合用于防止错误配置上线，比如禁止在 Release 模式下启用调试端口。

#error 会终止编译并显示自定义消息，例如：#if !RELEASE #error This build must be RELEASE mode. #endif
#warning 不中断构建，但会在 IDE 和 CI 日志中标红，适合提醒临时绕过行为，例如：#if DEBUG #warning Using mock service instead of real API.
二者都只在对应 #if 条件成立时触发，不满足则完全静默

不同于其他纯文本处理指令，#nullable 直接控制编译器是否启用可空引用类型检查和警告。它优先级高于项目级 <nullable>enable</nullable> 设置，且作用范围从指令出现位置起，到文件末尾或下一个 #nullable 指令为止。

#nullable enable 启用可空注解和警告；#nullable disable 完全关闭；#nullable restore 回退到项目级设置
不能写成 #if DEBUG #nullable enable #endif —— 预处理器不能拆解语法结构，这样会导致编译错误
混合使用时注意粒度：一个文件里可以多次切换上下文，但跨方法边界需显式标注，否则容易误判 nullability

真正难的不是记住语法，而是理解“编译前剔除”这个本质——所有被 #if 挡住的代码，对编译器来说就像从来没写过。一旦混淆了编译期和运行期边界，比如试图在 #if 外调用被剔除的方法，或者依赖被剔除的字段初始化顺序，问题就会变得非常隐蔽。