iOS模拟器运行Flutter应用时Xcode构建失败求助

你好，碰到这种“Framework 'Flutter' not found”和链接器错误，大概率是依赖缓存或者项目配置出了问题，我给你整理几个常用的解决步骤，你可以挨个试试：

先把你遇到的错误信息贴出来方便对照：

Launching lib/main.dart on iPhone 16 Pro in debug mode...
Running pod install...                                             15.5s
Running Xcode build...                                                  
Xcode build done.                                           43.8s
Failed to build iOS app
Error (Xcode): Framework 'Flutter' not found   
Error (Xcode): Linker command failed with exit code 1 (use -v to see invocation)

接下来试试这些解决方法：

• 清理Flutter项目缓存：先在项目根目录执行这两个命令，重置一下项目依赖

  flutter clean
  flutter pub get
  

• 重新安装iOS Pod依赖：进入ios目录，先移除现有pod再重新安装，避免依赖冲突

  cd ios
  pod deintegrate
  pod install
  

• 检查版本兼容性：用flutter doctor命令检查你的Flutter SDK、Xcode、CocoaPods版本是否匹配，有时候版本不兼容会导致框架找不到的问题，按照提示更新对应的工具就行。
• 验证Xcode框架路径配置：打开Xcode，找到你的项目Target，进入Build Settings，搜索“Framework Search Paths”，确认里面包含Flutter.framework的正确路径，一般是$(FLUTTER_ROOT)/bin/cache/artifacts/engine/ios，如果路径不对就手动添加。
• 清除Xcode衍生数据：Xcode的Derived Data有时候会残留缓存导致构建异常，你可以通过Xcode顶部菜单栏的Xcode -> Preferences -> Locations找到Derived Data的文件夹路径，删掉对应项目的缓存文件夹，然后重新构建。

如果上面的方法都没用，你可以试试重新生成iOS项目文件，执行flutter create .（注意是项目根目录，会覆盖ios和android文件夹，记得备份重要配置）。

备注：内容来源于stack exchange，提问作者Jack