Flutter iOS调试模式下print输出重复显示问题求助

AI 小北

2026-6-17

解决Flutter在iOS 15.8.3调试时print输出重复的问题

问题原因

这是Flutter结合Xcode 15.x在iOS 15及以下旧版本设备上的日志兼容性问题：Flutter的print方法会同时通过Flutter自身日志通道和iOS原生NSLog输出日志，旧iOS系统搭配新版Xcode时，控制台不会自动对这类重复日志做去重处理，导致同一条日志显示两次。iOS 17+系统日志机制优化后，以及Android、模拟器的日志通道逻辑不同，因此不会出现该问题。

解决方案

1. 直接替换`print`为`debugPrint`

Flutter官方提供的debugPrint方法内部已针对这类重复输出场景做了处理，用法和print完全一致，直接替换即可：

debugPrint("💡 Chat initialized");

2. 自定义日志工具类（按需选择）

如果不想全局替换print，可以写一个简单的工具类，针对iOS旧版本做日志输出控制：

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

void appLog(String message) {
  if (kDebugMode) {
    // iOS 15及以下版本仅使用debugPrint避免重复
    if (Platform.isIOS && !Platform.version.startsWith('16') && !Platform.version.startsWith('17')) {
      debugPrint(message);
    } else {
      print(message);
    }
  }
}

之后用appLog("💡 Chat initialized");替代原有的print调用。