Flutter iOS端Xcode编译报错：Module 'connectivity_plus'未找到

以下是针对性的排查和解决步骤，按顺序尝试：

• 确认Xcode打开的文件正确
  必须打开Runner.xcworkspace而非Runner.xcodeproj，后者不会加载Pod管理的第三方插件依赖，这是高频踩坑点。

• 重置Pod与Xcode缓存
  执行以下完整流程：

  flutter clean
  flutter pub get
  cd ios
  pod deintegrate
  pod cache clean --all
  rm -rf Podfile.lock Pods
  pod install
  

  完成后关闭Xcode，清空Xcode衍生数据：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

  再重新打开Runner.xcworkspace编译。

• 检查Xcode Build Settings配置
  进入Runner目标的Build Settings：

  1. 找到Framework Search Paths，确保包含$(inherited)和$(PROJECT_DIR)/Pods/connectivity_plus/ios，路径缺失则手动添加
  2. 找到Header Search Paths，确认包含$(inherited)和${PODS_ROOT}/Headers/Public/connectivity_plus
     注意：确保这些路径的Recursive选项处于勾选状态。

• 验证插件与Flutter版本兼容性
  查看pubspec.yaml中connectivity_plus的版本，确认和当前Flutter SDK版本匹配。尝试升级到最新稳定版，修改后执行flutter pub get再重新编译。

• 检查Xcode架构设置
  在Runner目标的Build Settings中：

  • 找到Architectures，设置为Standard Architectures (arm64, x86_64)
  • 找到Build Active Architecture Only，在Release模式下设置为NO（归档发布时需要编译全架构）

• 手动添加插件框架（最后尝试）
  打开Runner.xcworkspace，进入Runner目标的General标签页，找到Frameworks, Libraries, and Embedded Content：

  1. 点击+按钮，选择Pods/Products/connectivity_plus.framework
  2. 添加后将该框架的Embed选项设置为Embed & Sign

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