如何为Xcode添加构建配置一键开启所有ASAN诊断及环境选项

核心思路：自定义Build Configuration #

Xcode的Build Configuration是绑定构建、运行设置的核心载体，通过创建专属的Debug配置变体，把所有ASAN相关选项预配置完成后，切换时只需选择对应的Configuration就能一键生效，彻底告别手动逐个修改设置的繁琐操作。

具体操作步骤 #

1. 创建自定义Build Configuration

   • 打开项目设置（Project → Info），在Configurations区域点击+号，选择Duplicate Debug Configuration，将新配置命名为Debug (ASAN Enabled)。
   • 该配置会自动继承原Debug的所有基础设置，后续仅需修改ASAN相关参数。

2. 预配置ASAN及内存检查参数

   • 选中新创建的Debug (ASAN Enabled)配置，切换到Build Settings标签：
     • 搜索Address Sanitizer，设置为YES；
     • 搜索Malloc Scribble，设置为YES；
     • 找到需要开启的其余8项内存检查标志（如Malloc Guard Edges、Zombie Objects等），逐一设置为YES。
   • 打开Scheme设置（Product → Scheme → Edit Scheme），选择Run阶段：
     • 在Info标签的Build Configuration下拉框选中Debug (ASAN Enabled)；
     • 切换到Arguments标签，在Environment Variables中添加DYLD_INSERT_LIBRARIES并勾选Enabled。

3. 一键切换使用

   • 日常开发使用原Debug配置，需要进行内存检查时，只需在Xcode顶部的Build Configuration下拉框选择Debug (ASAN Enabled)，或在Scheme设置中切换对应Run配置，直接构建运行即可。
   • 切换回常规Debug模式时，选回原Debug配置，所有ASAN相关设置会自动恢复默认状态，无需手动关闭。

进阶优化：用xcconfig统一管理配置 #

如果项目包含多个Target，推荐用xcconfig文件集中管理ASAN配置，便于统一维护：

• 创建Debug-ASAN.xcconfig文件，写入以下内容：

  // 开启ASAN
  ADDRESS_SANITIZER = YES
  // 开启Malloc Scribble
  MALLOC_SCRIBBLE = YES
  // 其他内存检查标志示例
  MALLOC_GUARD_EDGES = YES
  ZOMBIE_OBJECTS = YES
  // 按需添加其余需要开启的标志
  

• 在项目设置的Debug (ASAN Enabled)配置中，将对应Target的Based On设置为Debug-ASAN.xcconfig，后续修改配置只需编辑xcconfig文件即可。

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