升级到Xcode13后STL出现std::hash重定义错误的原因问询

• SDK内置实现与自定义/第三方库特化冲突：Xcode13配套的iOS15.2 SDK在utility.h中新增了若干标准类型的std::hash特化实现，若项目、或者依赖的第三方库（如Protobuf、自研工具库等）自行实现了相同类型的std::hash特化，就会触发重定义错误。使用C20标准会加剧该问题：C20标准已经将部分常用类型的std::hash特化纳入标准，Xcode13的Clang实现了这部分规范，和旧版本库的兼容实现产生冲突。
• Clang模块导入冲突：编译参数启用了-fmodules（Clang模块功能），系统框架AVFoundation以模块化方式导入时会自动引入依赖的SDK STL头文件，若项目中其他位置以普通头文件引入方式导入了STL的functional或utility头文件，两种导入方式产生的命名空间定义会被Clang判定为重复实现。
• Apple Silicon模拟器架构适配问题：编译目标为arm64-apple-ios11.0-simulator（Apple Silicon芯片的iOS模拟器），Xcode13是首个正式支持该架构的Xcode版本，该架构对应的SDK头文件存在部分STL定义冗余的已知问题，同样会触发重定义错误。
• 模块缓存污染：升级Xcode后没有清理旧版本生成的模块缓存，导致新旧SDK的头文件被混合加载，触发定义冲突。

• 检查项目及第三方依赖中自定义的std::hash特化代码，加上inline关键字，或者用条件编译包裹，当检测到C++20或iOS15以上SDK时禁用自定义实现，使用SDK自带版本。
• 临时关闭Clang模块功能（将Build Settings中的Enable Modules (C and Objective-C)改为NO），或调整头文件引入顺序，先引入系统框架头文件，再引入自定义/第三方库的头文件。
• 若无需在Apple Silicon模拟器运行，可在Excluded Architectures中为模拟器架构添加arm64，暂时使用x86_64架构编译模拟器版本。
• 清空Xcode缓存：执行rm -rf ~/Library/Developer/Xcode/DerivedData命令清空衍生数据后重新编译。

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