调试Unit Tests Target时Xcode每次触发断点均报错

你遇到的这个'XCTestDefines.h' file not found错误，本质是Xcode在调试时优先找到了DerivedData里的XCTest框架副本，而非系统自带的完整XCTest框架，导致头文件缺失。结合你使用的Xcode 11.4.1和CocoaPods 1.9.1，我分享几个亲测有效的解决步骤：

• 先检查主App Target是否误加了XCTest依赖
  很多开发者会不小心把XCTest框架加到主App的Target里，这是最常见的诱因：

  1. 选中主App的Target，进入Build Phases → Link Binary With Libraries
  2. 如果看到XCTest.framework，直接点击移除

• 重置CocoaPods环境
  CocoaPods的缓存很容易导致框架路径混乱，执行以下命令彻底清理重装：

  pod deintegrate
  pod clean
  rm -rf Podfile.lock
  pod install
  

  完成后记得完全退出Xcode再重新打开项目。

• 强制Test Target优先使用系统XCTest
  调整Test Target的框架搜索路径，让它先找系统自带的XCTest：

  1. 选中你的Unit Test Target，进入Build Settings
  2. 搜索Framework Search Paths
  3. 添加路径：$(SDKROOT)/Developer/Library/Frameworks，并拖拽到列表最顶部（确保优先级最高）
  4. 删除任何指向DerivedData目录下XCTest的路径

• 清空DerivedData缓存
  DerivedData里的旧缓存文件经常会搞出各种奇怪的问题，直接删干净：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

  同样要完全退出Xcode（包括后台进程），再重新打开项目构建。

• 检查Podfile的Test Target配置
  确保Test Target的依赖配置正确，不要继承主App的全部依赖，建议用inherit! :search_paths来避免冲突：

  target 'APPNAME' do
    # 主App的依赖配置
  end
  
  target 'APPNAMETests' do
    inherit! :search_paths
    # 只添加测试相关的依赖，比如Quick、Nimble等
  end
  

如果以上方法都没用，可以试试创建一个全新的空项目，添加Unit Test Target运行看看——如果新项目没问题，那大概率是你现有项目的某个配置有隐藏冲突，建议逐步对比新老项目的构建设置差异。

内容的提问来源于stack exchange，提问作者Adi B.