MacOS编译QCefView遇std::filesystem::path不可用错误求解决

错误原因 #

• 部署目标未全局生效：仅在根项目设置CMAKE_OSX_DEPLOYMENT_TARGET，可能被QCefView子模块的本地配置覆盖，导致子项目仍使用更低的部署目标。
• C++标准版本未明确指定：std::filesystem是C17新增特性，若项目未强制启用C17，编译器不会提供该API支持，即使部署目标达标也没用。
• ARM架构的特殊限制：M系列芯片属于ARM架构，部分Xcode版本对该架构下的std::filesystem支持需要额外编译参数，仅设置部署目标无法触发。

修复方案 #

1. 全局强制配置部署目标与C++标准 #

在根CMakeLists.txt最开头添加以下代码，确保所有子项目继承配置：

set(CMAKE_OSX_DEPLOYMENT_TARGET "10.15" CACHE STRING "Minimum macOS version" FORCE)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

或者直接在cmake构建命令中传递参数：

cmake -S . -B build -DCMAKE_OSX_DEPLOYMENT_TARGET=10.15 -DCMAKE_CXX_STANDARD=17

2. 单独配置QCefView子项目 #

如果根项目配置无法传递到QCefView，找到它的CMakeLists.txt，添加目标专属配置：

target_compile_definitions(QCefView PRIVATE _LIBCPP_DISABLE_AVAILABILITY)
set_target_properties(QCefView PROPERTIES
    CXX_STANDARD 17
    CXX_STANDARD_REQUIRED ON
    OSX_DEPLOYMENT_TARGET 10.15
)

_LIBCPP_DISABLE_AVAILABILITY宏可以跳过libc++的版本检查，强制启用std::filesystem相关API。

3. 检查并升级Xcode #

确保使用的Xcode版本≥11（只有Xcode11及以上才完整支持macOS10.15的部署目标和C++17特性），如果版本过低，直接升级到最新兼容版本。

4. 清理旧构建缓存 #

之前的构建缓存可能残留旧配置，先删除缓存再重新构建：

rm -rf build
cmake -S . -B build [你的编译参数]

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