Xcode16执行pod init报错：未知ISA PBXFileSystemSynchronizedRootGroup

问题描述 #

在Xcode 16中创建新iOS项目后，执行pod init时触发以下错误：

RuntimeError - PBXGroup attempted to initialize an object with unknown ISA PBXFileSystemSynchronizedRootGroup

已尝试更新CocoaPods、Xcode及xcodeproj，但问题仍未解决。

环境信息 #

• Xcode 16.0
• CocoaPods: 1.15.2
• macOS 15.0
• 执行命令：/usr/local/bin/pod init

堆栈信息 #

CocoaPods : 1.15.2
        Ruby : ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.x86_64-darwin24]
    RubyGems : 3.0.3.1
        Host : macOS 15.0 (24A5331b)
       Xcode : 16.0 (16A242)
         Git : git version 2.39.5 (Apple Git-154)
Ruby lib dir : /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib
Repositories : trunk - CDN - https://cdn.cocoapods.org/

错误详情 #

RuntimeError - `PBXGroup` attempted to initialize an object with unknown ISA `PBXFileSystemSynchronizedRootGroup` from attributes: `{"isa"=>"PBXFileSystemSynchronizedRootGroup", "exceptions"=>["AE97BCA32C917722000D94D0"], "path"=>"tesPlayer", "sourceTree"=>"<group>"}`
If this ISA was generated by Xcode please file an issue.

解决方法 #

方法1：安装预发布版xcodeproj #

Xcode 16新增了PBXFileSystemSynchronizedRootGroup类型，当前正式版xcodeproj未支持，安装预发布版本即可解决：

sudo gem install xcodeproj --pre

方法2：手动修改项目配置文件 #

如果安装预发布版无效，可手动替换项目文件中的新类型：

• 右键iOS项目的.xcodeproj文件，选择「显示包内容」
• 打开project.pbxproj文本文件
• 全局搜索PBXFileSystemSynchronizedRootGroup，将所有匹配项替换为PBXGroup
• 保存文件后，重新执行pod init

方法3：降级Xcode #

若上述方法均不适用，可暂时降级到Xcode 15.x版本，等待CocoaPods正式发布支持Xcode 16的版本。

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