Flutter项目在Xcode构建时提示No such module 'GoogleMaps'错误求助

问题背景 #

使用Xcode构建Flutter项目时，持续报错No such module 'GoogleMaps'，但通过VSCode构建无异常，地图功能可正常运行。

解决方案 #

1. 移除Podfile中手动添加的pod 'GoogleMaps'
   google_maps_flutter插件会自动管理iOS端的Google Maps依赖，手动添加该行代码会导致依赖重复或版本不匹配，引发Xcode模块识别异常。修改后的Podfile头部如下：

# Uncomment this line to define a global platform for your project
#$FirebaseSDKVersion = '9.6.0'
$FirebaseSDKVersion = '10.7.0'
platform :ios, '14.0'

# 移除此行：pod 'GoogleMaps'

2. 彻底清理并重新安装依赖
   依次执行以下命令清理缓存与依赖：

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

3. 重置Xcode索引与工作区

• 完全关闭Xcode
• 删除项目根目录下的Runner.xcworkspace文件
• 重新打开ios/Runner.xcworkspace（注意选择xcworkspace而非xcodeproj）
• 等待Xcode完成索引构建后，再尝试编译

4. 检查Framework搜索路径
   打开Xcode的Runner target → Build Settings → 搜索Framework Search Paths，确保包含以下路径（若缺失则添加）：

$(inherited)
$(PROJECT_DIR)/Pods/GoogleMaps/Base/Frameworks
$(PROJECT_DIR)/Pods/GoogleMaps/Maps/Frameworks

路径需根据实际Pods安装位置调整，确保指向GoogleMaps的Framework目录。

5. 验证AppDelegate配置
   确认import GoogleMaps仅在AppDelegate中存在，且该文件属于Runner target，无多余或错误的导入语句。

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