readability-avoid-unconditional-preprocessor-if

通过分析 #if 条件(例如 #if 0#if 1 等),查找始终启用或禁用的预处理指令代码块。

#if 0
    // some disabled code
#endif

#if 1
   // some enabled code that can be disabled manually
#endif

无条件的预处理指令,例如用于禁用代码的 #if 0 和用于启用代码的 #if 1,会导致死代码和始终启用的代码。死代码会使理解代码库更加困难,阻碍可读性,并且可能是未完成功能或已放弃功能的标志。这会导致维护问题、未来开发人员的困惑以及潜在的编译问题。

针对这两种情况的解决方案,请考虑使用预处理宏或定义,例如 #ifdef DEBUGGING_ENABLED,来控制代码的启用或禁用。这种方法在处理代码库的不同部分时提供了更好的协调和灵活性。或者,您可以使用 /* */ 块注释注释掉整个代码,并添加一个提示,例如 @todo,以指示未来的操作。