升级Xcode15.0.1与macOS Sonoma后项目编译循环依赖问题求助

1. 先清缓存再说 #

• 按Cmd + Shift + K清理项目缓存，再按Cmd + Option + Shift + K清理DerivedData
• 嫌快捷键麻烦的话，直接手动删除~/Library/Developer/Xcode/DerivedData里对应项目的文件夹，彻底清干净

2. 检查Build Settings里的关键开关 #

• 找到Build Options下的Enable Index-While-Building Functionality，改成No——Xcode15默认开启这个功能，很多老项目会出现兼容问题
• 查看Linking里的Other Linker Flags，删掉废弃标记、重复的库引用或者过时的-ObjC相关配置
• 把Deployment Target临时调到14.1试试，之前低于14.0的版本可能在Sonoma下存在兼容隐患

3. 第三方依赖是重灾区 #

• 用CocoaPods的话，先执行pod deintegrate再执行pod install，强制让依赖重新适配Xcode15环境
• 检查所用第三方库是否有更新，很多库都推出了Xcode15兼容版本，替换为最新版测试
• 手动引入的静态库/框架，确认是否支持arm64架构，Sonoma对架构的要求比之前更严格

4. 再仔细扒一遍Build Phases细节 #

• 查看Compile Sources里有没有重复添加的文件，或者标红找不到的文件，及时删除或补全
• 检查Copy Bundle Resources里是否存在同名资源（比如两个同名xib或图片），这类冲突很容易引发编译错误
• 排查Run Script阶段的脚本，是否用到了Xcode14的特定路径或命令（比如xcodebuild参数变化），修改脚本适配Xcode15的环境变量

5. 终极排查法 #

• 新建一个Xcode15空白项目，将原项目的文件和配置逐步迁移进去，定位到引发问题的具体文件或配置项
• 重置Xcode偏好设置：终端执行defaults delete com.apple.dt.Xcode，重启Xcode后重新配置项目，可能是配置文件损坏导致的问题

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