Flutter项目iPad运行提示Module 'image_picker' not found如何解决

算力阿峰

2026-10-8

可行解决步骤（针对仅iPad真机触发该报错的场景）

校验架构配置
打开Xcode中Runner项目的Build Settings，找到Excluded Architectures配置项，确保仅在*模拟器（iphonesimulator）*的配置下排除arm64架构，不要全局或在真机（iphoneos）配置下添加arm64排除规则，iPad真机运行依赖arm64架构。
统一iOS部署版本
1. 确认ios/Podfile中顶部的全局iOS版本设置为platform :ios, '11.0'（image_picker 0.8.x系列最低支持iOS 11.0）
2. 打开Xcode Runner项目的General面板，检查Deployment Info下iPhone和iPad的部署目标版本一致且均≥11.0；同时切换到Build Settings面板，确认Debug、Release、Profile三类配置下的iOS Deployment Target全部统一为≥11.0的版本
全量清理缓存重新构建
按顺序执行以下命令：
```
flutter clean
rm ios/Podfile.lock
rm -rf ios/Pods
rm pubspec.lock
flutter pub get
cd ios && pod install --repo-update
```
构建时务必打开Runner.xcworkspace文件而非Runner.xcodeproj

修正Podfile编译配置
在ios/Podfile的post_install代码块中补充模块化和架构配置，修改后完整块如下：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      # 启用Clang模块化支持，解决模块识别问题
      config.build_settings['CLANG_ENABLE_MODULES'] = 'YES'
      # 移除真机架构排除规则
      config.build_settings['EXCLUDED_ARCHS[sdk=iphoneos*]'] = ''
    end
  end
end

修改后重新执行pod install再构建

清理Xcode衍生数据
打开Xcode偏好设置（Preferences）→ Locations，点击Derived Data路径旁的箭头进入文件夹，删除文件夹内所有内容后重新启动Xcode构建
混编项目额外配置
如果项目存在OC与Swift混编，在Runner的Build Settings中将Always Embed Swift Standard Libraries设置为YES