从Bitbucket克隆Xcode项目后项目导航器部分分组及文件不显示

核心原因 #

• Xcode的分组结构存储在项目配置文件中，与Finder磁盘文件无强制绑定：所有分组、文件引用、target关联规则均保存在项目包内的project.pbxproj文件中，仅将源代码文件推送到远程仓库、未同步提交更新后的project.pbxproj，就会出现本地磁盘文件完整但Xcode导航器不显示的问题。
• 分组为Xcode虚拟组：Xcode中默认创建的黄色分组为逻辑虚拟组，仅用于项目内逻辑分类，不会主动同步磁盘上的新增文件夹/文件，只有手动添加到项目配置的分组才会在导航器展示。
• project.pbxproj被误过滤：如果项目的.gitignore规则中添加了*.pbxproj的匹配规则，或者多人协作时解决该文件冲突时误删了部分分组配置，也会导致远程仓库的项目配置缺失对应分组信息。
• Xcode索引缓存异常：少数情况下Xcode加载克隆项目时索引构建失败，也会导致已存在的分组无法正常展示。

修复方案 #

• 先核对远程仓库中xxx.xcodeproj/project.pbxproj的内容，确认缺失的分组是否已经被写入配置，如未写入需要原提交人补充推送最新的项目配置文件。
• 检查本地.gitignore文件，删除*.pbxproj相关的忽略规则，避免后续项目结构修改无法同步到远程仓库。
• 本地临时修复可右键Xcode导航器空白处，选择「Add Files to 项目名」，选中Finder中缺失的对应文件夹，添加时勾选对应target，Added folders项选择「Create groups」即可恢复分组展示。
• 如为缓存问题，退出Xcode后执行命令rm -rf ~/Library/Developer/Xcode/DerivedData清除缓存，再重新打开项目即可。

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