Flutter iOS真机编译失败：module 'fluttertoast' not found

我之前也碰到过一模一样的情况——模拟器跑起来毫无问题，切到真机编译就弹出这个模块找不到的错误，大概率是iOS端的依赖缓存或者Pod配置出了纰漏，按下面的步骤一步步排查应该能搞定：

1. 彻底清理并重装依赖 #

这是最常用的解决思路，先把旧的缓存和依赖清干净重来：

• 在项目根目录执行：flutter clean，清空Flutter的构建缓存
• 进入项目的ios文件夹，执行：pod deintegrate，完全移除当前的Pod依赖
• 接着在ios目录执行：pod install，重新拉取并安装所有iOS端依赖
• 回到项目根目录，执行：flutter pub get，确保Flutter侧的依赖同步完成

2. 检查Xcode项目配置细节 #

有时候Pod的自动配置会出问题，需要手动确认关键配置：

• 打开iOS项目时，一定要选Runner.xcworkspace（别打开Runner.xcodeproj，否则Pod依赖不会被正确加载）
• 选中Runner目标，进入Build Settings标签：
  • 找到Framework Search Paths，确保里面包含$(inherited)和${PODS_ROOT}/fluttertoast/ios，如果没有就手动添加
  • 找到Other Linker Flags，确认里面有-ObjC，缺失的话补上即可

3. 匹配Flutter版本的fluttertoast版本 #

如果你的Flutter版本较新，旧版fluttertoast可能存在兼容性问题：

• 打开pubspec.yaml，把fluttertoast的版本号更新到最新稳定版（比如当前可以用^8.2.2）
• 执行flutter pub get，再重复第一步的Pod清理安装流程

4. 苹果芯片Mac的特殊处理 #

如果你的Mac是M1/M2芯片，可能需要额外适配：

• 执行pod install时，用arch -x86_64 pod install来兼容x86架构的Pod依赖
• 或者在Xcode的Runner目标Build Settings里，把Excluded Architectures针对模拟器设置为arm64（真机不要设置）
• 也可以右键点击Xcode图标，选择"使用Rosetta打开"，再重新编译项目

最后别忘了重启环境 #

有时候缓存残留会导致配置不生效，关掉Xcode和所有终端窗口，重新打开项目再编译试试，大概率就能解决问题了。

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