Flutter项目无法在iOS模拟器构建，已试多种方案仍失败

一、解决flutterfire命令未找到问题 #

• 全局激活flutterfire_cli工具：

  dart pub global activate flutterfire_cli
  

• 检查并配置.zshrc的PATH路径：
  1. 打开.zshrc文件：open ~/.zshrc
  2. 添加pub全局工具路径：

     export PATH="$PATH":"$HOME/.pub-cache/bin"
     

  3. 使配置生效：source ~/.zshrc
• 验证：执行flutterfire --version确认命令可正常调用

二、修复IPHONEOS_DEPLOYMENT_TARGET版本不兼容问题 #

仅修改Podfile的全局设置可能无法覆盖所有依赖Pod的配置，需添加统一覆盖逻辑：

1. 打开ios目录下的Podfile，在文件末尾添加以下代码：

   post_install do |installer|
     installer.pods_project.targets.each do |target|
       target.build_configurations.each do |config|
         config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
       end
     end
   end
   

2. 重新执行Pod安装：

   cd ios
   pod deintegrate
   pod install
   

三、排查CocoaPods配置异常 #

• 检查CocoaPods版本，过低版本可能导致兼容性问题：

  pod --version
  

  若版本低于1.12.0，更新到最新稳定版：

  sudo gem install cocoapods
  

• 清理Pod缓存并重新初始化：

  pod cache clean --all
  pod repo remove trunk
  pod repo add trunk https://cdn.cocoapods.org/
  

• 确认CocoaPods路径已加入系统PATH：
  执行echo $PATH查看是否包含/usr/local/bin（CocoaPods默认安装路径），若未包含，在.zshrc中添加：

  export PATH="/usr/local/bin:$PATH"
  

  然后执行source ~/.zshrc生效

四、额外排查步骤 #

• 打开Xcode，进入Settings > Locations，确认Command Line Tools选择的是当前使用的Xcode版本
• 在ios目录下打开Runner.xcworkspace，直接用Xcode执行构建，查看更详细的报错日志，定位具体冲突的依赖
• 重新执行Flutter清理与依赖拉取：

  flutter clean
  flutter pub get
  cd ios && pod install
  

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