终端执行pod install报错 无法启动模拟器运行Flutter项目怎么办

• 终端执行pod install命令时出现运行异常，异常状态如下图：
  
• 异常引发连锁故障：iOS模拟器无法正常拉起，项目根目录执行flutter run命令时启动失败，终端返回报错：could not build the application for the simulator. error launching application，应用始终无法正常启动。

按以下顺序依次操作，每步完成后可以重试pod install和flutter run验证问题是否修复：

1. 全量清理构建缓存
   进入Flutter项目根目录，依次执行以下命令清理旧的构建产物、依赖锁文件：

   flutter clean
   rm -rf ios/Pods ios/Podfile.lock
   flutter pub get
   

2. 修复CocoaPods环境问题
   首先执行pod --version检查本地CocoaPods版本，版本号低于1.12时先执行升级命令：

   sudo gem install cocoapods
   # M系列芯片Mac需要额外执行以下命令安装ffi依赖，避免架构兼容报错
   sudo arch -x86_64 gem install ffi
   

   升级完成后进入iOS目录，更新本地spec仓库，带详细日志执行install方便定位卡点：

   cd ios
   pod repo update
   pod install --verbose
   

   如果执行过程中提示模拟器架构冲突，打开ios目录下的Podfile文件，找到post_install代码块，添加架构排除配置：

   post_install do |installer|
     installer.pods_project.targets.each do |target|
       flutter_additional_ios_build_settings(target)
       # 新增以下配置解决模拟器编译arm64架构冲突
       target.build_configurations.each do |config|
         config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
       end
     end
   end
   

   修改保存后重新执行pod install即可。
3. 修复Xcode配置异常
   打开Xcode，进入Settings > Locations页面，确认Command Line Tools选项选中的是当前已安装的Xcode正式版本，没有留空或选中测试版/未完成安装的版本。之后执行以下命令重置Xcode命令行路径、手动拉起模拟器验证可用性：

   sudo xcode-select --reset
   open -a Simulator
   

   等模拟器完全加载进入系统首页后，回到项目根目录重新执行flutter run。
4. 特殊场景处理
   如果以上步骤执行后仍报错，根据pod install --verbose输出的具体日志针对性处理：
   • 报权限错误时，执行sudo chmod -R 755 ios/Pods给依赖目录加读写执行权限
   • 报依赖包哈希校验失败、文件损坏时，执行pod cache clean --all清空本地CocoaPods全局缓存，再重新拉取依赖

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