Flutter 3.19.5+Xcode15.2：iOS真机部分调试报错仅Xcode可见

使用Xcode 15.2 + Flutter 3.19.5调试iOS物理设备时，遇到两个异常情况：

1. 部分Dart运行时异常（如type 'Null' is not a subtype of type 'Map<String, dynamic>' in type cast）仅在Xcode控制台输出，VSCode调试控制台完全看不到；但RenderFlex布局类异常仍能正常在VSCode显示。
2. 调试iOS真机必须同时打开Xcode才能正常运行，此前无此要求。

1. 修复VSCode无法捕获部分Dart异常的问题 #

调整VSCode调试配置 #

• 打开项目.vscode目录下的launch.json（没有就新建），添加或修改配置确保以debug模式启动：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter",
      "request": "launch",
      "type": "dart",
      "flutterMode": "debug",
      "args": ["--debug"]
    }
  ]
}

• 打开VSCode设置，搜索Dart: Debug Track Widget Creation和Dart: Debug Catch Exceptions，勾选开启这两个选项。

手动添加全局异常捕获 #

在main.dart入口处添加全局异常监听，强制把异常输出到控制台：

void main() {
  // 捕获Flutter框架层异常
  FlutterError.onError = (FlutterErrorDetails details) {
    FlutterError.presentError(details);
    print('Flutter Error: ${details.exception}');
  };
  // 捕获Isolate级别的底层异常
  PlatformDispatcher.instance.onError = (error, stack) {
    print('Isolate Error: $error');
    return true;
  };

  runApp(const MyApp());
}

2. 解决必须打开Xcode才能调试的问题 #

重置iOS项目依赖与构建缓存 #

• 关闭Xcode和VSCode，删除项目根目录下的ios/Pods、ios/Podfile.lock、.dart_tool、build文件夹。
• 终端进入项目根目录，依次执行：

flutter clean
flutter pub get
cd ios
pod install --repo-update
cd ..

• 重新打开VSCode，直接连接真机启动调试，无需打开Xcode。

更新VSCode插件与Xcode命令行配置 #

• 打开VSCode扩展面板，把Flutter和Dart插件升级到最新版，重启VSCode。
• 终端执行xcode-select -p，确认输出路径为/Applications/Xcode.app/Contents/Developer，若不是则执行：

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

3. 额外验证步骤 #

• 调试时切换VSCode控制台到Dart Console标签（部分版本可能叫Debug Console），确认是否能看到异常输出。
• 新建一个空白Flutter项目，复现类型转换异常，排查是否是当前项目的特殊配置导致问题。

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