You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

升级Xcode13后Flutter iOS真机运行报'Flutter/Flutter.h' not found错误

问题核心原因

升级Xcode13后出现的构建失败核心触发点为下方报错:

fatal error: 'Flutter/Flutter.h' file not found

该问题是旧版本Flutter SDK、旧版Flutter插件与Xcode13新构建系统不兼容,导致Flutter相关头文件引用路径失效导致,可按以下步骤依次排查解决:

修复步骤
  • 第一步:升级兼容Xcode13的依赖版本
    你当前使用的path_provider 1.6.28版本未适配Xcode13,先将pubspec.yaml中path_provider依赖升级至2.0.11及以上版本,执行命令:
    flutter pub upgrade path_provider

  • 第二步:清理本地缓存与旧构建产物
    依次执行以下命令清理冗余缓存:

flutter clean
rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
flutter pub get
  • 第三步:重新生成iOS依赖配置
    进入ios目录执行pod重置命令:
cd ios
pod deintegrate
pod install
  • 第四步:修正Xcode构建设置
    打开ios目录下的Runner.xcworkspace文件,进入项目Build Settings配置页:
  1. 搜索Excluded Architectures,在Debug和Release配置下,对模拟器SDK添加排除架构arm64
  2. 搜索iOS Deployment Target,将最低支持版本调整为12.0及以上,与第三方插件的最低支持版本对齐
  • 第五步:重置Flutter项目配置
    在项目根目录执行以下命令,重新生成Flutter默认的iOS端配置,不会覆盖已有业务代码与签名配置:
    flutter create .

如果上述步骤执行完成后仍然报错,将Flutter稳定版升级至2.5.3及以上版本即可,低于2.5的Flutter版本官方未适配Xcode13,执行命令flutter upgrade即可升级。

内容的提问来源于stack exchange,提问作者DaegilPyo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.01 17:06:01