Xcode15运行iPhone项目报链接器错误，Xcode14.3.1正常求解决方案

问题分析 #

Xcode 15.0的链接器（ld）引入了更严格的符号检查和平台校验规则，之前Xcode 14.3.1容忍的重复符号、目标文件（.o）缺失平台信息等问题，现在会直接触发链接失败。

优先尝试的修复方案 #

1. 定位具体重复符号 #

在Xcode的Build Settings中，找到Other Linker Flags，添加-v参数，重新编译项目。查看编译日志的详细输出，找到54 duplicate symbols对应的具体符号名称和所属文件，明确问题来源。

2. 清理重复定义 #

• 检查Build Phases > Link Binary With Libraries，确认是否有重复添加的静态库，移除重复项。
• 排查代码中的全局变量、函数：如果多个文件中定义了同名全局变量，改为static限定作用域；如果头文件中直接实现函数，将实现移到.m文件，或用static修饰。
• 若使用CocoaPods，检查是否存在同一库被同时通过Podfile和手动导入的情况，统一用Pod管理。

3. 修复第三方库适配问题 #

如果错误提示的.o文件来自第三方库：

• 优先更新该库到支持Xcode 15的最新版本，多数主流库已完成适配。
• 若无法更新，尝试开启Build Settings > Linking > Dead Code Stripping为YES，或调整Other Linker Flags中的参数（比如移除可能导致冲突的-all_load、-force_load等）。

4. 清理项目缓存 #

• 执行Cmd+Shift+K清理项目编译缓存。
• 删除Derived Data：打开Xcode → Settings → Locations，点击Derived Data路径旁的箭头，删除对应文件夹，再重新编译。

降级到Xcode 14.3.1的操作（Sonoma 14系统） #

如果上述方案无效，可暂时降级，步骤如下：

1. 从Apple开发者渠道下载Xcode 14.3.1安装包（确保下载支持Ventura及以上系统的版本，Sonoma兼容）。
2. 备份当前Xcode 15：将/Applications/Xcode.app重命名为Xcode15.app，移至其他目录。
3. 安装Xcode 14.3.1：将下载的Xcode14.3.1.app放入/Applications文件夹。
4. 切换默认Xcode版本：打开终端，执行命令：

   sudo xcode-select -s /Applications/Xcode14.3.1.app/Contents/Developer
   

5. （可选）同时保留两个版本：右键Xcode14.3.1.app → Show Package Contents，编辑Contents/Info.plist，将CFBundleIdentifier改为com.apple.dt.Xcode14，保存后即可同时运行两个版本的Xcode。
6. 安装对应Command Line Tools：打开Xcode 14.3.1 → Preferences → Locations，在Command Line Tools下拉菜单中选择对应版本。

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