Xcode15 Beta运行项目报错求助：Xcode14.3可正常运行

问题背景 #

使用Xcode15 Beta运行项目时出现链接错误，Xcode14.3运行同一项目无异常，报错信息：

Library 'iconv.2.4.0' not found
Linker command failed with exit code 1 (use -v to see invocation)

核心原因 #

Xcode15 Beta调整了系统库的链接策略，旧版iconv.2.4.0的引用路径或版本标识不再适配新环境，而Xcode14.3仍沿用旧的库引用逻辑。

解决方案 #

1. 修改项目的库引用规则 #

• 打开项目Build Settings，搜索Other Linker Flags
• 找到直接引用-liconv.2.4.0的条目，替换为通用的-liconv（Xcode会自动适配当前SDK支持的iconv版本）

2. 更新第三方依赖 #

若报错来自CocoaPods等管理的第三方库：

• 执行终端命令pod update，将所有依赖更新至适配Xcode15的最新版本
• 若某依赖未更新适配，可手动修改其配置文件，把iconv.2.4.0的引用替换为iconv

3. 清理Xcode缓存 #

• 关闭Xcode，执行终端命令rm -rf ~/Library/Developer/Xcode/DerivedData删除Derived Data
• 按下Cmd+Shift+K清理项目后重新构建

4. 检查库搜索路径 #

• 在Build Settings中搜索Library Search Paths，移除旧版iconv的硬编码路径
• 确保路径中包含$(SDKROOT)/usr/lib，让Xcode自动从系统SDK中查找正确的库版本

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