XCode 16.2 Clang编译C++20报错：std::atomic_ref不在std命名空间中

使用XCode 16.2自带的Clang编译器构建C++代码时，出现编译错误：

error: no member named 'atomic_ref' in namespace 'std'

错误触发代码行：

assert((reinterpret_cast<ptrdiff_t>(pRed) & (std::atomic_ref<float>::required_alignment - 1)) == 0);

编译命令已指定C++20标准：

/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++  ... omitted ... -g -std=c++20 -arch arm64 ... omitted ... -c /Users/amonra/.vs/DSS/DeepSkyStackerKernel/StackingEngine.cpp

疑问：macOS/XCode是否不提供std::atomic_ref？

XCode的Clang编译器本身支持C++20的std::atomic_ref特性，但该特性的启用受macOS部署目标版本限制：

• 若你的项目部署目标（macOS Deployment Target）低于12.0（Monterey），Clang会默认禁用std::atomic_ref，因为该特性依赖较新的系统底层支持。
• 解决步骤：
  • 若使用XCode IDE：在项目设置中，将macOS Deployment Target调整为12.0或更高版本；
  • 若使用命令行编译：在编译命令中添加-mmacosx-version-min=12.0参数，确保编译器启用对该特性的支持。

补充：XCode 16.2对应的Clang版本已完整支持std::atomic_ref，只需确保部署目标版本符合要求即可。

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