MacOS下Clang忽略C++14版本设置引发编译错误问题

问题场景 #

在Mac OS 11.6.8（Intel）和Mac OS 12.5.1（M1）环境下，使用Xcode 13.2.1，通过VS Code+CMake构建项目，已在CMakeLists.txt中指定set(CMAKE_CXX_STANDARD 14)，且Clang编译命令包含-std=gnu++14参数，但编译时出现大量标准库相关错误：

Intel平台错误示例 #

In file included from /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX12.1.sdk/usr/include/c++/v1/iterator:419:
[build] /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX12.1.sdk/usr/include/c++/v1/__functional_base:80:16: error: no template named 'unary_function'; did you mean 'binary_function'?
[build]         static unary_function<_Ap, _Rp>

M1平台错误示例 #

In file included from /Users/me/data/series2server/main.cpp:3: THIS LINE SAYS #include<string>
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/string:519:
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/__debug:14:
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/iosfwd:98:
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/__mbstate_t.h:29:
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/wchar.h:123:
In file included from .../MacOSX12.3.sdk/usr/include/wchar.h:91:
In file included from /Users/me/data/series2server/restbed_server/model/time.h:24: THIS LINE SAYS #include <memory>
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/memory:674:
In file included from .../MacOSX12.3.sdk/usr/include/c++/v1/__memory/allocator.h:18:
.../MacOSX12.3.sdk/usr/include/c++/v1/stdexcept:83:32: error: unknown type name 'string'
    explicit logic_error(const string&);

初期排查误区 #

• 误以为错误源于Boost 1.80.0使用了C17已移除的unary_function特性，但项目已明确指定C14标准
• 怀疑Apple的MacOSX SDK破坏了C++17之前版本的兼容性，但SDK路径本身并非问题根源

最终原因 #

错误源于代码生成器创建的Time.h文件与系统头文件同名冲突：
从错误栈可见，编译过程中包含<memory>时，优先找到了项目目录下的time.h（而非系统头文件），而该自定义头文件未正确处理依赖，导致后续系统标准库头文件的解析被破坏，进而出现unary_function、string等未定义的错误。

解决方案 #

• 重命名自定义头文件：将代码生成器输出的time.h改为唯一名称（如ProjectTime.h），彻底避免与系统头文件冲突
• 规范头文件包含：在项目代码中，对自定义头文件使用相对路径包含（如"restbed_server/model/time.h"），区分于系统头文件的<>包含方式
• 调整包含路径优先级：在CMake中调整include目录顺序，确保系统头文件路径优先级高于项目本地目录（不推荐，可能引发其他依赖问题）

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