如何在Flutter/Dart中实现类似#ifdef的调试代码剔除功能？

完全可以实现，Dart提供了编译期条件判断和条件导入的能力，能让调试代码在生产环境中彻底被剔除，效果和直接从代码库删除一致，比kReleaseMode或assert的运行时判断更彻底。下面是两种常用方案：

方案一：编译常量+条件代码块 #

通过dart-define编译参数定义调试标识，配合const bool.fromEnvironment做编译期判断，编译器会直接移除不满足条件的代码分支，不会出现在最终产物中。

示例代码：

void main() {
  // 仅当编译时传入DEBUG=true时，这段代码才会被保留
  if (const bool.fromEnvironment('DEBUG')) {
    // 调试专属逻辑：调用调试函数、使用调试数据
    _debugOnlyPrint("调试模式启动");
    print(_debugSecretData);
  }

  // 业务逻辑代码
  print("正常业务流程");
}

// 仅调试模式下存在的函数和数据
void _debugOnlyPrint(String msg) {
  print("[DEBUG] $msg");
}

const _debugSecretData = {"debug_key": "debug_value"};

编译命令：

• 调试模式（保留调试代码）：

  flutter run --dart-define=DEBUG=true
  

• 生产打包（剔除调试代码）：

  flutter build apk --release
  

  （无需传递DEBUG参数，默认会识别为false，编译器自动移除对应代码）

方案二：分离文件+条件导入 #

把调试代码和生产环境的空实现分成两个文件，通过条件导入让编译器在不同环境下选择对应文件，生产环境的空实现还会被Dart的tree shaking进一步优化移除。

1. 创建调试实现文件 debug_tools.dart：

void debugLog(String message) {
  print("[DEBUG] $message");
}

class DebugInspector {
  static void checkObject(Object obj) {
    // 调试环境专属的对象检查逻辑
    print("Inspecting: $obj");
  }
}

2. 创建生产环境空实现文件 debug_tools_stub.dart：

void debugLog(String message) {}

class DebugInspector {
  static void checkObject(Object obj) {}
}

3. 在业务代码中条件导入：

// 编译期自动选择导入文件：DEBUG=true时用真实实现，否则用空实现
import 'debug_tools_stub.dart'
    if (const bool.fromEnvironment('DEBUG')) 'debug_tools.dart';

void main() {
  debugLog("这条日志仅调试模式可见");
  DebugInspector.checkObject({"data": 123});

  // 业务逻辑
  print("业务代码执行");
}

关键注意点 #

• 必须使用const bool.fromEnvironment，不能省略const——只有const构造的环境变量判断才会在编译期生效，非const的话会变成运行时判断，代码依然会被打包。
• 和kReleaseMode的区别：kReleaseMode是运行时跳过代码执行，但代码本身仍存在于二进制中；而上述方案是编译期直接剔除代码，完全符合你要的“等同于删除”的效果。

内容的提问来源于stack exchange，提问作者Martin