Flutter debug模式运行耗时过长 Xcode构建阶段长达30分钟
问题结论
你贴出的依赖版本不存在兼容性或配置错误,flutter doctor检测无异常的前提下,「Running Xcode Build」阶段耗时30分钟基本是iOS原生依赖编译特性、本地构建配置不合理导致,不属于项目配置错误。
对应原因与处理方案
- 无缓存首次构建的正常耗时
集成的firebase_core、cloud_firestore、firebase_auth三个Firebase组件对应的iOS原生SDK体量大,首次构建、执行过flutter clean、删除过ios/build目录的场景下,Xcode没有历史编译缓存,需要全量编译所有关联原生代码,Intel芯片Mac机型耗时20-40分钟属于正常范围,后续增量构建耗时通常会降到2-5分钟。 - Debug模式编译架构配置错误
打开ios/Runner.xcworkspace,选中Runner target进入Build Settings,找到Build Active Architecture Only配置项,确认Debug模式下值为Yes。如果Debug模式下该值为No,Xcode会同时编译全架构二进制安装包,构建耗时会达到正常水平的3-5倍。 - CocoaPods依赖配置未优化
- 打开项目路径下的
ios/Podfile,在文件顶部添加配置use_frameworks! :linkage => :static,开启Firebase SDK静态链接,跳过大部分源码编译步骤 - 依次执行以下命令重装iOS依赖:
cd ios pod deintegrate pod install --repo-update - 如果构建进度长期停留在
Fetching podspec阶段,是CocoaPods官方源国内访问速度慢导致,替换为国内镜像源即可解决,和项目本身配置无关。
- 打开项目路径下的
- 本地环境IO性能拖慢
开启Time Machine实时备份、第三方杀毒软件实时扫描项目目录的场景下,编译阶段的文件读写速度会被大幅拖慢,将项目目录加入实时扫描/备份排除列表即可恢复正常构建速度。
快速排查技巧
首次构建直接在Xcode中触发,Xcode会展示每个编译阶段的具体进度,可以直接定位到耗时异常的步骤,不需要在VS Code/Android Studio中等待无明确进度的构建过程。
内容的提问来源于stack exchange,提问作者Karel Debedts
相关产品推荐
相关产品推荐

