如何在主CMake项目中条件性全局添加STL兼容头文件目录？

1. 重构StlLibPolyfill为INTERFACE库 #

修改lib/StlLibPolyfill/CMakeLists.txt，将其定义为INTERFACE库（若包含编译源码则改为STATIC库），确保头文件路径和编译规则能自动传递给所有依赖它的目标：

# 纯头文件polyfill用INTERFACE库
add_library(StlLibPolyfill INTERFACE)

# 设置头文件目录，BEFORE关键字确保优先级高于系统标准库，优先加载polyfill
target_include_directories(StlLibPolyfill INTERFACE BEFORE
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

# 可选：添加编译宏，用于代码中区分是否启用polyfill
target_compile_definitions(StlLibPolyfill INTERFACE
    USE_STL_POLYFILL
)

如果polyfill包含编译源码（非纯头文件），则调整为：

add_library(StlLibPolyfill STATIC src/polyfill_impl.cpp)

target_include_directories(StlLibPolyfill PUBLIC BEFORE
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

target_compile_definitions(StlLibPolyfill PUBLIC
    USE_STL_POLYFILL
)

2. 在主项目中统一管理依赖传递 #

修改main_project/CMakeLists.txt，先引入所有子项目，再根据AVR环境给依赖的子项目自动添加polyfill链接，无需修改子项目的配置：

# 先引入util_project子项目
add_subdirectory("../util_project" "${CMAKE_BINARY_DIR}/util_project")

# 仅在AVR环境下引入并关联polyfill库
if(IS_AVR)
    add_subdirectory("../lib/StlLibPolyfill" "${CMAKE_BINARY_DIR}/lib/StlLibPolyfill")
    # 给util_project添加polyfill依赖，子项目无需做任何环境判断
    target_link_libraries(util_project PRIVATE StlLibPolyfill)
endif()

# 链接主项目与util_project
target_link_libraries(${PRODUCT_NAME} PRIVATE util_project)

3. 效果验证 #

• 编译桌面版本时，IS_AVR为假，util_project直接使用系统标准库
• 编译Arduino版本时，util_project会自动加载StlLibPolyfill的头文件，无需在其CMakeLists中添加任何额外代码

这种方式完全满足需求：仅主项目需要处理环境判断，所有子项目无需关心标准库的来源，自动适配不同编译环境。

内容的提问来源于stack exchange，提问作者Tomáš Zato