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

升级macOS Monterey和Xcode后Flutter无法在iOS模拟器构建报错如何解决

Flutter 升级macOS Monterey、Xcode后iOS模拟器构建失败解决方案

核心报错原因

升级系统和Xcode后出现的Xcode命令行工具路径偏移、Flutter iOS侧配置缓存失效、CocoaPods本地依赖配置不匹配,导致构建所需的配置文件无法正常读取。

修复步骤

  • 第一步:重置Xcode命令行工具路径
    关闭所有打开的Xcode、Android Studio窗口,打开终端执行如下命令:
    sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
    
    注意 执行sudo命令需要输入本机用户密码,输入过程中密码不会显示,输入完成按回车即可。执行完成后运行xcode-select -p,确认输出路径和上面设置的路径一致即可。
  • 第二步:清理项目缓存和无效配置文件
    进入Flutter项目根目录,执行清理命令:
    flutter clean
    
    手动删除项目ios目录下的Pods文件夹、Podfile.lock文件,同时删除ios/Flutter目录下的Debug.xcconfig、Release.xcconfig文件。
  • 第三步:重新生成项目配置与依赖
    回到项目根目录执行命令拉取Flutter依赖:
    flutter pub get
    
    进入ios目录重新安装CocoaPods依赖:
    cd ios
    pod install --repo-update
    
  • 第四步:测试构建
    回到项目根目录,直接在Android Studio中点击运行,或者执行如下命令运行:
    flutter run -d "iPhone 12"
    

可选补充方案

如果执行以上步骤后依旧报错,可以先更新CocoaPods到最新版本后重新执行上述修复步骤:

sudo gem install cocoapods

如果仍有xcfilelist读取报错,可以手动打开项目ios目录下的Runner.xcworkspace文件,在Xcode中选中Runner项目,进入「Build Phases」标签页,找到「[CP] Embed Pods Frameworks」和「[CP] Check Pods Manifest.lock」两个配置项,删除其中显示为红色的无效路径,保存后关闭Xcode重新执行pod install即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.28 10:27:03