Release方案下静态库链接错误：误查找Debug版本静态库

这种情况我遇到过好几次，大概率是项目的构建配置或者静态库的引用方式出了问题，给你几个排查和解决的方向：

1. 检查项目的Other Linker Flags配置 #

打开项目的Build Settings，搜索Other Linker Flags，看看是不是直接写死了-lTestLib_d这种Debug版本的库名。正确的做法应该是用条件编译变量来区分：

• 点击该设置项右边的+号，选择Add Build Setting Condition
• 针对Debug配置，添加-lTestLib_d
• 针对Release配置，添加-lTestLib

这样构建时会根据当前scheme的配置自动选择对应的库名。

2. 确认静态库的target引用配置 #

如果你是把静态库的target作为项目的依赖（通过Build Phases -> Target Dependencies添加的），要检查静态库target的Build Configuration是否和主项目匹配：

• 打开主项目的scheme（Product -> Scheme -> Edit Scheme）
• 切换到Build标签页，找到你的TestLib静态库target
• 确保它的Configuration和主项目当前的配置一致（比如主项目选Release，这里也要选Release）

很多时候就是这里没对应上，导致构建主项目Release时，静态库还是构建Debug版本，链接器自然去找libTestLib_d.a。

3. 检查Library Search Paths的条件配置 #

如果你的静态库是放在外部目录（不是项目内的target依赖），那要确保Library Search Paths也做了条件区分：

• 同样在Build Settings里找到Library Search Paths
• 添加条件配置，Debug指向Debug版库的路径，Release指向Release版库的路径
• 避免直接写死一个包含Debug库的路径，导致Release时也去那里找

4. 清理缓存并重新构建 #

有时候Xcode的缓存会导致这种奇怪的问题，按以下步骤操作：

• 执行Cmd + Shift + K清理当前项目的构建缓存
• 执行Cmd + Option + Shift + K清理整个Xcode的派生数据（Derived Data）
• 关闭Xcode，删除项目目录下的xcuserdata文件夹
• 重新打开项目，选择Release scheme重新构建

5. 二次确认静态库的归档配置 #

虽然你说静态库的归档名称正确，但还是可以再核对一下静态库target的Build Settings：

• 打开TestLib的Build Settings，搜索Product Name
• 确保Debug配置下是TestLib_d，Release配置下是TestLib
• 同时检查Archive Path是否做了对应的区分，避免归档时不同版本的库互相覆盖

按照这几个步骤排查下来，基本能解决链接器找错库的问题。

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