Flutter中dart:developer的log()失效，寻求更优调试日志方案

一、修复dart:developer.log()无输出的问题 #

• 确认处于Debug模式：log()仅在Debug环境生效，Release模式会被自动剔除。可通过kDebugMode（需导入package:flutter/foundation.dart）判断当前模式。
• 检查IDE控制台过滤规则：比如Android Studio的Logcat如果设置了只显示WARN及以上级别，会过滤掉log()默认的INFO级输出。可显式指定日志级别强制输出：

  import 'dart:developer' as dev;
  import 'package:flutter/foundation.dart';
  
  if (kDebugMode) {
    dev.log('你的日志内容', level: 0); // level设为0会绕过大部分过滤
  }
  

• 重启调试环境：部分模拟器或设备可能存在日志缓存问题，重启设备或IDE后重试。

二、解决logger包截断长日志的问题 #

logger默认会截断过长的日志内容，只需自定义输出逻辑即可解决：

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

final logger = Logger(
  printer: PrettyPrinter(
    printEmojis: false, // 关闭 emoji 减少冗余信息
    methodCount: 1, // 只显示当前调用方法，简化日志定位
  ),
  output: _CustomLogOutput(),
);

class _CustomLogOutput extends LogOutput {
  @override
  void output(OutputEvent event) {
    if (kDebugMode) {
      // 用debugPrint并设置超大wrapWidth，彻底避免截断
      debugPrint(event.lines.join('\n'), wrapWidth: 10000);
    }
  }
}

配置后，logger的格式化日志会通过debugPrint完整输出，同时保留logger的结构化打印优势。

三、更顺手的替代方案：自定义轻量日志工具 #

如果觉得现成工具都不合心意，自己封装一个结合两者优点的工具也很简单：

import 'package:flutter/foundation.dart';

void appLog(String message, {String tag = 'APP_DEBUG'}) {
  if (kDebugMode) {
    // 带tag的完整输出，方便快速筛选
    debugPrint('[$tag] $message', wrapWidth: 10000);
    // 若需要在系统Logcat中单独过滤，可搭配dart:developer的log
    // dev.log(message, name: tag);
  }
}

这个工具既保证长日志不截断，又通过tag快速定位日志来源，比原生debugPrint更易用。

四、额外调试技巧 #

• 打印复杂对象时，先转为格式化字符串：比如用dart:convert的JsonEncoder格式化JSON数据，可读性大幅提升：

  import 'dart:convert';
  
  final complexData = {'user': {'name': 'test', 'age': 20}, 'tags': ['flutter', 'debug']};
  appLog(const JsonEncoder.withIndent('  ').convert(complexData));
  

• 善用IDE的日志筛选功能：Android Studio Logcat可通过tag搜索过滤，VS Code调试控制台支持关键词高亮，能大幅降低日志定位的繁琐程度。

内容的提问来源于stack exchange，提问作者Jagal R Nath