预处理器指令是编译前的文本筛选，不满足条件的代码块不会进入语法分析、不生成IL；#define必须位于文件最顶部、无分号、仅限当前文件；#if剔除代码而非运行时跳过；#error/#warning在编译解析阶段触发；#nullable直接影响类型系统。
预处理器指令不是运行时逻辑，而是编译前的文本筛选——不满足条件的代码块根本不会进入语法分析，也不会生成任何 IL。
#define 必须放在文件最顶部，且不能带分号
很多新手在类内部或 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 / #elif / #else 编译时剔除，不是运行时跳过
写 #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 在编译阶段强制干预
#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 直接控制编译器是否启用可空引用类型检查和警告。它优先级高于项目级 <Nullable>enable</Nullable> 设置，且作用范围从指令出现位置起，到文件末尾或下一个 #nullable 指令为止。
-
#nullable enable启用可空注解和警告；#nullable disable完全关闭；#nullable restore回退到项目级设置 - 不能写成
#if DEBUG #nullable enable #endif—— 预处理器不能拆解语法结构，这样会导致编译错误 - 混合使用时注意粒度：一个文件里可以多次切换上下文，但跨方法边界需显式标注，否则容易误判 nullability
真正难的不是记住语法，而是理解“编译前剔除”这个本质——所有被 #if 挡住的代码，对编译器来说就像从来没写过。一旦混淆了编译期和运行期边界，比如试图在 #if 外调用被剔除的方法，或者依赖被剔除的字段初始化顺序，问题就会变得非常隐蔽。
