执行flutter run时出现Xcode错误，求助解决方案

报错信息 #

Error (Xcode): 'Flutter/Flutter.h' file not found
/Users/mustafa/Downloads/Flutter%20Starter%20Template%20/ios/Runner/GeneratedPluginRegistrant.h:9:8

Error (Xcode): failed to emit precompiled header
'/Users/mustafa/Library/Developer/Xcode/DerivedData/Runner-ebkdimfgzvdbnvbwufevtglbxnzo/Build/Intermediates.noindex/PrecompiledHeaders/Runner-Bridging-Header-swift_3LFM7QFA8RRIV-clang_32ZU5P1SDEB18.pch' for bridging header
'/Users/mustafa/Downloads/Flutter Starter Template/ios/Runner/Runner-Bridging-Header.h'

解决步骤 #

• 清理Flutter项目缓存
  执行以下命令彻底清理项目依赖：

  flutter clean
  flutter pub get
  

• 重置iOS Pod依赖
  进入项目ios目录，执行Pod相关操作：

  cd ios
  pod deintegrate
  pod install --repo-update
  

• 检查Xcode头文件搜索路径

  1. 打开ios目录下的Runner.xcworkspace（不要打开.xcodeproj文件）
  2. 选中Runner目标，进入Build Settings面板
  3. 搜索Header Search Paths，确保包含以下路径并设置为recursive：
     • $(inherited)
     • $(FLUTTER_ROOT)/flutter
     • $(FLUTTER_ROOT)/flutter/include

• 删除Xcode派生数据

  1. 打开Xcode，点击菜单栏Xcode > Settings > Locations
  2. 点击Derived Data旁的箭头，删除当前项目对应的派生数据文件夹，或直接清空整个Derived Data目录
  3. 重启Xcode后重新编译项目

• 修正项目路径问题
  你的项目路径包含空格和转义字符%20，这会导致Xcode解析路径出错。建议将项目移动到无空格、无特殊字符的路径下，比如/Users/mustafa/FlutterProjects/StarterTemplate

• 验证Flutter环境完整性
  执行flutter doctor检查环境配置，修复所有提示的错误（如Xcode命令行工具安装、iOS模拟器配置等）

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