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

Flutter 2.5.1升级后iOS模拟器编译报错'Flutter/Flutter.h'文件找不到

Flutter升级后iOS构建Flutter/Flutter.h找不到问题解决方案

按照以下顺序执行操作即可解决:

1. 清理Flutter侧缓存与依赖

  • 执行全局清理命令:flutter clean
  • 删除项目根目录下的pubspec.lock文件
  • 重新拉取项目依赖:flutter pub get

2. 清理iOS侧缓存与重新安装依赖

  • 进入iOS目录:cd ios
  • 删除旧的pod配置与依赖文件:rm -rf Podfile.lock Pods/
  • 清理Xcode遗留的派生数据缓存:rm -rf ~/Library/Developer/Xcode/DerivedData/*
  • 重新安装pod依赖并更新仓库源:pod install --repo-update

3. 校验Xcode配置(上述操作无效时执行)

  • 打开项目时选择ios/Runner.xcworkspace文件,不要打开.xcodeproj后缀的文件
  • 进入Runner项目的Build Settings配置页,搜索Excluded Architectures,确认Debug、Release模式下模拟器对应的排除架构为arm64,所有Pods子项目的该配置需要和主项目保持一致
  • 搜索Framework Search Paths,确认配置项中存在$(inherited),且排序在最顶部

4. Podfile版本校验

  • 打开ios/Podfile文件,确认顶部的iOS最低版本配置为platform :ios, '11.0',Flutter 2.0+要求最低支持iOS 11.0,版本低于11.0时修改后重新执行pod install

所有操作执行完成后回到项目根目录,重新运行flutter run构建即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.03 09:24:00