复制Xcode构建配置未修改却无法编译运行问题

问题场景 #

我尝试在Xcode中创建新构建配置实现差异化操作，步骤如下：

• 进入Project -> AppName -> Info -> Configurations
• 点击+按钮，复制“Debug”配置
• 将新配置命名为“Experiment”
• 编辑AppName Scheme -> Run，将构建配置改为新创建的Experiment配置
• 切换后无法编译运行，报错均指向DEBUG编译条件未定义，但该宏在原Debug配置中存在。对比project.pbxproj里的Debug和Experiment配置代码，除了内容顺序不同外完全一致。

环境：Xcode 15.4、macOS 14.5

解决方法 #

1. 检查Target级别的预处理器宏 #

项目级配置复制后，部分Target可能没同步继承宏定义：

• 打开Project面板，选中对应Target，切换到Build Settings标签
• 搜索Preprocessor Macros（预处理器宏）
• 切换到Experiment配置，确认是否存在DEBUG=1，没有的话手动添加

2. 彻底清理缓存再编译 #

Xcode缓存可能导致配置未生效：

• 按Cmd + Shift + K清理构建文件夹
• 按Cmd + Option + Shift + K清理派生数据
• 重启Xcode后重新编译项目

3. 确认Scheme全阶段配置 #

Scheme的其他阶段如果仍用旧配置，可能引发冲突：

• 按Cmd + <打开Scheme编辑界面
• 依次检查Run、Test、Profile、Archive每个阶段，确保Build Configuration都设为Experiment
• 重点检查Test阶段，很多时候这里会默认保留Debug配置，导致宏定义不一致

4. 调整project.pbxproj中的宏定义顺序 #

虽然理论上顺序不影响，但Xcode 15.4可能对存储顺序敏感：

• 找到project.pbxproj中Experiment配置的GCC_PREPROCESSOR_DEFINITIONS字段
• 把DEBUG=1调整到宏列表的最前面，和Debug配置的顺序保持完全一致
• 保存文件后重新打开项目

5. 重新关联Target与项目配置 #

确保Target的Experiment配置正确基于项目的Debug配置：

• 回到Project -> Info -> Configurations页面
• 查看每个Target对应的Experiment配置下拉选项，确认是Based on Project Settings (Debug)
• 如果不是，重新选择基于Debug配置的选项

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