Xcode 16项目执行pod install时遇PBXFileSystemSynchronizedRootGroup错误

问题根源 #

Xcode 16.0引入了新的项目文件类型PBXFileSystemSynchronizedRootGroup，但CocoaPods 1.15.2版本未适配该类型，导致执行pod install时触发PBXGroup无法初始化未知ISA类型的错误。

解决办法 #

1. 升级CocoaPods到兼容版本

这是最彻底的解决方案，CocoaPods 1.15.3及以上版本已修复Xcode 16的适配问题：

• 执行升级命令：

  gem install cocoapods
  

• 若使用Rbenv管理Ruby环境，安装后需刷新环境：

  rbenv rehash
  

• 验证版本：

  pod --version
  

  确认版本≥1.15.3后，重新执行pod install。

2. 临时修改项目文件（不推荐长期使用）

如果暂时无法升级CocoaPods，可临时修改项目的.xcodeproj文件：

• 右键点击项目的.xcodeproj文件，选择「显示包内容」。
• 打开project.pbxproj文件，全局搜索PBXFileSystemSynchronizedRootGroup。
• 将所有匹配到的该类型替换为PBXGroup，保存文件。
• 重新执行pod install。

注意：此方法为临时方案，后续在Xcode中调整项目结构（如添加/删除文件组）可能会再次触发该问题，建议尽快升级CocoaPods。

3. 清理项目缓存后重新安装

配合上述方案，清理旧缓存可避免残留问题：

• 执行命令卸载现有Pods集成：

  pod deintegrate
  

• 删除项目目录下的Pods文件夹、Podfile.lock文件和.xcworkspace文件。
• 重新执行pod install。

4. 确认Podfile配置正确性

确保Podfile中iOS版本和Google Maps SDK的配置符合要求：

platform :ios, '13.0' # Google Maps SDK最低要求iOS 13.0
use_frameworks!

target 'YourProjectName' do
  pod 'GoogleMaps' # 或指定兼容版本，如pod 'GoogleMaps', '~> 7.4.0'
end

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