Release配置下运行Swift Package单元测试遇@testable模块编译错误求解决

问题根源 #

默认配置下，Xcode的Release构建不会为主模块开启测试支持，而@testable导入需要模块编译时包含测试相关符号与调试信息，因此会触发该错误。以下是两种通过Scheme或Build Settings解决的实用方案：

方案一：通过Scheme编辑器配置构建参数 #

1. 打开Scheme编辑器：点击顶部工具栏的Scheme下拉菜单，选择「Edit Scheme」
2. 切换到Test选项卡，左侧选中你的测试目标，右侧「Info」标签页中，将Build Configuration改为Release
3. 切换到Build选项卡，找到你的主应用/框架目标，勾选它的「Run」和「Test」复选框
4. 点击主目标右侧的展开箭头，将它的Build Configuration改为Release，同时确认Debug Information Format设置为DWARF with dSYM File（这一步让主模块在Release模式下生成支持测试的调试符号）
5. 关闭Scheme编辑器，重新运行测试即可

方案二：修改主目标的Build Settings #

1. 选中项目中的主目标，进入Build Settings标签页
2. 搜索Enable Testability，将Release配置下的该选项值改为YES
3. 继续搜索Debug Information Format，确保Release配置下设置为DWARF with dSYM File
4. 回到Scheme编辑器，将Test的Build Configuration设为Release，重新构建测试

注意事项 #

• 开启Enable Testability仅影响用于测试的Release构建，不会干扰归档发布的产物（归档时可单独配置为默认Release参数）
• 如果项目有自定义的Release衍生配置（比如Staging），可仅给特定配置开启上述选项，无需修改全局Release配置

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