如何构建并分发iOS Debug构建版本？

核心逻辑：Xcode的Archive操作本身没有绑定固定的构建配置，之前你能通过Archive流程生成Release包，是因为项目默认Scheme的Archive动作关联了Release配置，只要调整这个关联，就能用和Release完全一致的流程生成Debug配置的安装包。

标准可视化界面操作流程 #

• 第一步调整Scheme的Archive构建配置
  • 点击Xcode顶部工具栏的Scheme选择下拉框，选中「Edit Scheme...」
  • 在配置窗口左侧菜单栏找到「Archive」项，将右侧「Build Configuration」下拉选项从默认的Release修改为Debug
  • 保持「Debug executable」选项为勾选状态，避免生成的包丢失调试关联能力
• 第二步生成并导出Debug ipa
  • 配置保存后，照常走Product -> Archive流程，等待Xcode完成构建后自动跳转至Organizer归档管理窗口
  • 在归档列表中选中刚生成的归档包（可通过右键包选择「Show in Finder」，打开xcarchive包内的Info.plist，查看BuildConfiguration字段值为Debug确认包类型，避免和之前的Release归档混淆）
  • 点击窗口右上角的「Distribute App」，按照和Release包完全一致的流程选择分发渠道（Ad Hoc、内部分发渠道、开发团队测试渠道等），完成签名校验、导出路径选择后，即可拿到Debug配置的ipa安装包

高频踩坑注意事项 #

• 签名证书匹配问题：Debug构建默认适配开发类签名证书，如果导出时选择了App Store分发、企业级发布类证书，虽然可以成功导出ipa，但安装后会出现启动闪退、无法附加调试器的问题，导出前需确认签名证书和实际分发场景匹配。
• 调试符号完整性问题：Debug构建的包默认会内嵌完整调试符号，导出时在「App Thinning」步骤选择「None」（不要生成架构切片包），避免后续做崩溃日志符号化时因为架构不全无法定位问题栈。
• 配置还原问题：使用完Debug Archive配置后，记得回到Edit Scheme窗口将Archive的BuildConfiguration改回默认Release，避免后续误操作打出Debug版本的正式安装包。

无界面切换的命令行快速方案 #

如果不想修改Xcode的Scheme默认配置，可以通过xcodebuild命令直接指定Debug配置完成构建导出，不影响日常开发的默认设置：

• 执行归档构建命令，指定Debug配置输出xcarchive包：xcodebuild archive -project 你的项目文件名.xcodeproj -scheme 你的项目Scheme名 -configuration Debug -archivePath ./debug_output/debug_build.xcarchive
• 按照预设的导出配置文件执行ipa导出：xcodebuild -exportArchive -archivePath ./debug_output/debug_build.xcarchive -exportPath ./debug_output/exported_ipa -exportOptionsPlist 你的导出配置.plist

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