开启Undefined Behavior Sanitizer后Protocol引用出现歧义错误

问题场景 #

为Scheme开启**Undefined Behavior Sanitizer（UBSan）**后，所有包含<AppKit/AppKit.h>的.mm文件都报大量"Reference to 'Protocol' is ambiguous"编译错误，错误源头均为系统NS系列头文件。

• 哪怕是新建一个只写了#import <AppKit/AppKit.h>的空test.mm文件，同样会触发该错误
• 排查后锁定是预编译头（Precompile Prefix Header）导致：关闭项目的Precompile Prefix Header选项后错误消失，但单文件编译时间从2秒涨到6秒，且无法单独给单个文件禁用预编译头

解决方案 #

1. 预编译头中强制指定Protocol归属 #

在项目的前缀头文件（如YourProject-Prefix.pch）里，调整AppKit的导入顺序，先定义宏强制Protocol指向系统的objc_protocol：

// 先定义宏避免歧义
#define Protocol objc_protocol
#import <AppKit/AppKit.h>
// 用完取消宏定义，不影响其他代码
#undef Protocol

这种方式既能保留预编译头的编译加速效果，又能彻底解决命名冲突。

2. 添加全局编译标记 #

在启用UBSan的Build Configuration中，给Other C Flags和Other C++ Flags都添加编译参数：

-DProtocol=objc_protocol

通过全局宏定义直接规避命名冲突，无需修改预编译头内容，适合不想改动前缀头的项目。

3. 优化预编译头内容 #

如果项目前缀头导入了过多框架，可以尝试只把高频、无冲突的框架留在预编译头里，将AppKit移到具体.mm文件中单独导入。这种方式会小幅增加编译时间，但比完全关闭预编译头快很多。

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