macOS命令行工具Swift XCTest单元测试构建失败如何解决？

为啥会踩这个坑？因为用Command Line Tool模板建的是可执行程序，不是框架，单元测试根本没法直接导入可执行目标的代码；另外你主文件里的全局执行代码（let code = MyCode(); code.hello()），在测试构建的时候会重复运行，也会引发冲突。

给你两种解决办法，按需选择：

办法一：拆分核心代码到框架（推荐，适合长期维护） #

• 新建框架Target：点击File > New > Target，选择macOS分类下的Framework模板，命名为MyProjectCore（或自定义名称）。
• 迁移核心代码：把原MyProject中的MyCode类完整剪切到新框架的.swift文件中，原主文件仅保留全局执行逻辑。
• 让命令行工具依赖框架：选中MyProject目标，进入General标签页，在Frameworks, Libraries, and Embedded Content区域点击+，添加MyProjectCore框架，然后修改主文件代码：

  import Foundation
  import MyProjectCore
  
  let code = MyCode()
  code.hello()
  

• 调整测试Target依赖：选中MyTests目标，同样在General标签页添加MyProjectCore框架依赖，修改测试文件的导入语句：

  import XCTest
  @testable import MyProjectCore
  
  class MyTests: XCTestCase {
      func testCode() {
          let sol = MyCode()
          sol.hello()
      }
  }
  

• 清理缓存重新构建：按下Shift+Command+K清理构建文件夹，再重新构建测试Target即可。

办法二：用条件编译跳过全局代码（快速临时解决） #

如果不想额外创建框架，可通过条件编译避免全局代码干扰测试：

• 修改原主文件代码，将全局执行逻辑包裹在条件编译块中：

  import Foundation
  
  class MyCode {
      func hello() {
          print("hello")
      }
  }
  
  // 仅在非测试环境执行这段代码
  #if !TESTING
  let code = MyCode()
  code.hello()
  #endif
  

• 选中MyTests目标，进入Build Settings，搜索Other Swift Flags，添加编译标记-D TESTING，这样测试构建时就不会执行全局代码，同时测试文件中的@testable import MyProject也能正常生效。

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