Flutter iOS项目Xcode构建报错：ld: framework 'Flutter' not found

问题场景 #

使用Xcode构建Flutter iOS应用时，触发以下链接错误：

• ld: framework 'Flutter' not found
  clang: error: linker command failed with exit code 1 (use -v to see invocation)

已尝试的解决步骤 #

• 在ios目录执行 pod install --repo-update
• 清理Derived Data：rm -rf ~/Library/Developer/Xcode/DerivedData
• 执行 flutter clean 和 flutter pub get

额外排查与修复方案 #

1. 检查Framework搜索路径
   打开ios目录下的.xcworkspace，进入项目Build Settings，找到Framework Search Paths，确保包含：

   • $(inherited)
   • $(FLUTTER_FRAMEWORK_DIR)
     若路径缺失，手动添加并设置为recursive。

2. 确认Flutter SDK路径配置
   执行 flutter doctor 检查SDK路径是否正常，若异常：

   • 配置FLUTTER_ROOT环境变量指向正确的Flutter SDK目录
   • 或在Xcode中通过Flutter > Select Flutter SDK指定路径

3. 重新生成iOS项目文件
   备份ios目录后，执行命令重新生成项目：

   flutter create --platforms ios .
   

   完成后重新执行 pod install。

4. 验证Flutter.framework完整性
   前往Flutter SDK的bin/cache/artifacts/engine/ios目录，确认Flutter.framework存在。若缺失，执行：

   flutter precache --ios
   

   重新下载框架文件。

5. 检查Xcode版本兼容性
   确认当前Xcode版本与Flutter版本兼容，可参考Flutter官方版本说明调整Xcode或Flutter版本。

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