Dart中print语句触发Avoid `print` calls in production code警告如何解决？

这个警告来自Dart官方默认开启的linter规则avoid_print，触发的核心原因是原生print方法不适合生产环境使用：

• 无环境限制：print的输出逻辑在debug、release模式下都会执行，如果代码里留下了打印敏感数据（用户隐私、接口密钥、业务核心参数）的print调用，生产环境运行时这些数据会直接暴露在运行日志中，存在严重的安全泄露风险
• 无管控能力：原生print没有日志分级、过滤、持久化、上报能力，生产环境出问题时无法通过日志排查问题，高频调用还会额外占用IO资源，拖累应用运行性能

根据日志的使用场景可以分为两类处理方式：

仅调试阶段需要的临时日志 #

这类日志不需要带到生产环境，可以用以下方式处理，不会触发警告：

• Flutter项目直接使用debugPrint方法，该方法默认仅在debug模式下输出日志，release模式自动失效：

import 'package:flutter/foundation.dart';
debugPrint('Foo'); 

• 通用方案：加debug模式判断包裹print调用，release模式下这部分代码会被编译优化完全移除，不会有性能损耗：

import 'package:flutter/foundation.dart';
if (kDebugMode) {
  print('Foo');
}

纯Dart非Flutter项目可以用断言实现同样效果：

assert(() {
  print('Foo');
  return true;
}());

生产环境也需要保留的业务/错误日志 #

不要用print，使用专门的日志框架实现生产级日志管理，官方推荐使用logging库，可以实现以下能力：

• 自定义日志分级：区分debug、info、warning、error等级别，不同环境配置不同的输出策略，比如debug模式输出所有级别日志到控制台，生产模式仅收集warning以上级别的日志
• 支持日志持久化、上报：生产环境可以将日志写入本地分片文件，或者上报到你的日志服务平台，方便线上问题排查
• 支持统一脱敏配置：可以在日志输出前统一过滤敏感字段，避免隐私数据泄露

基础使用示例：

import 'package:logging/logging.dart';
import 'package:flutter/foundation.dart';

// 初始化Logger实例
final logger = Logger('AppLogger');

void initLogger() {
  // 配置日志级别
  Logger.root.level = kDebugMode ? Level.ALL : Level.WARNING;
  // 配置日志处理逻辑
  Logger.root.onRecord.listen((record) {
    if (kDebugMode) {
      // debug模式打印到控制台
      print('${record.level.name} [${record.time}] ${record.message}');
      if (record.error != null) print('错误详情：${record.error}');
      if (record.stackTrace != null) print('堆栈：${record.stackTrace}');
    } else {
      // 生产环境执行自定义上报/持久化逻辑
      reportLogToService(record);
    }
  });
}

// 业务代码中使用
logger.info('用户进入首页');
logger.warning('接口请求超时，正在重试');
logger.error('接口请求失败', error: err, stackTrace: stack);

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