iOS模拟器运行Flutter项目遇Xcode错误：Module 'cloud_firestore'未找到

你遇到的问题是真机Profile模式运行正常，但iOS模拟器报错Module 'cloud_firestore' not found，且常规的pod清理重装操作无效。以下是针对性的解决方法：

1. 调整Podfile中的架构配置 #

当前Podfile里强制设置模拟器架构为x86_64，这可能和Firebase依赖的架构支持冲突（比如M系列Mac的模拟器默认用arm64）。修改post_install块中的架构配置：

把原来的：

config.build_settings['ARCHS[sdk=iphonesimulator*]'] = 'x86_64'

替换为：

# 让Xcode自动适配模拟器架构，兼容Intel和M系列Mac
config.build_settings['ARCHS[sdk=iphonesimulator*]'] = '$(ARCHS_STANDARD)'

如果是Intel Mac，也可以直接注释掉这一行，然后重新执行pod install。

2. 为Firebase依赖启用模块化头文件 #

在Podfile的target 'Runner' do块内，手动指定Firebase相关依赖的模块化头文件配置，避免编译时的模块识别问题：

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  # 添加以下内容
  pod 'Firebase', :modular_headers => true
  pod 'FirebaseCore', :modular_headers => true
  pod 'CloudFirestore', :modular_headers => true

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

修改后执行pod deintegrate，再重新pod install。

3. 彻底清理缓存并重建 #

• 打开Xcode，按Cmd + Shift + K清理构建文件夹；
• 关闭Xcode，删除~/Library/Developer/Xcode/DerivedData下对应项目的缓存目录；
• 回到项目根目录，执行：

  flutter clean
  flutter pub get
  cd ios
  pod install
  

4. 检查依赖版本兼容性 #

确保cloud_firestore版本与当前Flutter SDK兼容。可以在pubspec.yaml中升级到最新稳定版：

flutter pub add cloud_firestore:^4.17.1 # 替换为最新稳定版号

更新后重新执行flutter pub get和pod install。

5. 调整Xcode项目的架构设置 #

打开ios目录下的Runner.xcworkspace：

• 选中Runner项目，进入Build Settings；
• 找到Architectures -> Architectures，设置为Standard Architectures (arm64, x86_64)；
• 找到Build Active Architecture Only，将Debug模式设为Yes，Release/Profile模式设为No；
• 找到Excluded Architectures，Debug模式下添加对应架构：M系列Mac添加arm64，Intel Mac添加x86_64。

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