Flutter构建IPA正常但build ios/run提示Flutter/Flutter.h未找到

flutter build ipa默认走Release模式+真机arm64架构构建链路，Flutter构建脚本会自动给Release配置注入正确的头文件搜索路径、依赖关联规则；而flutter build ios、flutter run默认走Debug模式，同时覆盖iOS模拟器的x86_64/arm64模拟器架构，两类构建的配置是完全隔离的。常规的pod更新、删除Flutter.podspec操作只会同步Release侧配置，Debug/模拟器侧的头文件路径、架构编译规则没有被正确更新，就会出现打IPA正常、调试编译报'Flutter/Flutter.h' file not found的现象。

按顺序执行以下操作，不要跳步：

• 先完全关闭Xcode、Android Studio，在项目根目录执行全量清理命令：

flutter clean
rm -rf ios/Pods ios/Podfile.lock ios/.symlinks ios/Flutter/Flutter.framework ios/Flutter/Flutter.podspec build
flutter pub get

• 进入ios目录重置pod配置后重新安装依赖：

cd ios
pod deintegrate
pod install --repo-update
cd ..

• 打开ios目录下的Runner.xcworkspace（注意不要打开Runner.xcodeproj，否则不会加载pod依赖），检查3项核心配置：
  1. 选中Runner target，切换到Build Settings标签，搜索Header Search Paths，选中Debug配置项（不要只改Release），添加以下路径并设置为recursive：
     • $(SRCROOT)/Pods/Headers/Public
     • $(FLUTTER_ROOT)/bin/cache/artifacts/engine/ios
     • 额外给模拟器编译添加路径：$(FLUTTER_ROOT)/bin/cache/artifacts/engine/ios_simulator
  2. 同一标签下搜索Build Active Architecture Only，将Debug模式的值设为Yes，Release模式保持No即可。Debug模式下如果设为No会同时编译全量架构，无法匹配模拟器对应的Flutter头文件。
  3. 切换到Build Phases标签，检查[CP] Check Pods Manifest.lock、Embed Flutter Frameworks两个脚本的执行顺序，必须排在Compile Sources步骤之前，顺序不对直接拖拽调整即可。
• 配置完成后先在Xcode中选中任意iOS模拟器目标，按Command+B执行编译，编译通过后回到终端执行flutter run即可正常调试。

如果上述步骤执行完仍然报错，打开ios/Runner.xcodeproj/project.pbxproj文件，全局搜索FRAMEWORK_SEARCH_PATHS，检查所有Debug配置条目下是否包含"$(inherited)"值，缺失的话手动补上即可——老版本Flutter升级上来的项目经常会出现该配置被覆盖、无法继承pod和Flutter依赖路径的问题。

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