c++oding="utf-8" ?>
头文件路径不生效的根本原因是作用域选错：PRIVATE仅自身可见，PUBLIC使头文件和依赖透传给下游，INTERFACE仅导出头文件；链接时需PUBLIC/INTERFACE链接才能继承传递依赖，且install必须显式导出INTERFACE属性并处理依赖链。
target_include_directories 为什么头文件路径总不生效？
根本原因常是作用域没选对：PRIVATE、PUBLIC、INTERFACE 决定头文件是否透传给依赖者。比如你写 target_include_directories(mylib PRIVATE include/)，下游 target_link_libraries(app mylib) 就找不到 mylib 的头文件——因为 PRIVATE 只影响 mylib 自身编译，不导出。
正确做法取决于用途：
- 仅自己源码需要（如内部实现头）→ 用
PRIVATE - 既自己用，又要求链接它的目标也能
#include（如公开 API 头）→ 用PUBLIC - 纯头文件库（如
fmt、range-v3）→ 用INTERFACE，且通常配合target_compile_features或target_compile_options一并导出
常见错误：把第三方库头路径也塞进 PRIVATE，结果下游编译失败；或漏掉 $ 导致 install 后路径错乱。
target_link_libraries 的 PRIVATE/PUBLIC/INTERFACE 怎么配才不翻车？
这和头文件逻辑对称，但更易出隐性问题。例如：
target_link_libraries(mylib PUBLIC fmt::fmt) target_link_libraries(app PRIVATE mylib)
此时 app 能用 mylib，但无法直接用 fmt::fmt —— 因为 mylib 把 fmt 声明为 PUBLIC，而 app 是 PRIVATE 链接，不继承传递依赖。
真正控制“下游能否用被依赖项”的是链接时的可见性组合：
-
mylib用PUBLIC链fmt→fmt成为mylib接口的一部分 -
app用PUBLIC或INTERFACE链mylib→ 才能自动获得fmt的链接信息和头路径 -
app用PRIVATE链mylib→ 仅获得mylib符号，fmt不透传
现代 C++ 项目中，若 mylib 的头文件里直接用了 fmt::format，就必须让 fmt 至少是 PUBLIC，否则下游编译器看不到 fmt 的声明。
如何用 target_compile_features 和 target_compile_options 封装编译器特性？
直接在 CMakeLists.txt 顶层写 set(CMAKE_CXX_STANDARD 20) 是粗粒度控制，掩盖了模块差异。正确封装方式是按 target 绑定：
add_library(core STATIC core.cpp) target_compile_features(core PUBLIC cxx_concepts cxx_ranges) target_compile_options(core PRIVATE $:-fconcepts>) target_compile_options(core INTERFACE $:/std:c++20>)
关键点：
-
target_compile_features的PUBLIC表示：链接core的目标必须支持这些特性，CMake 会自动检查并报错 -
target_compile_options的PRIVATE仅影响core自身编译；INTERFACE则强制下游使用对应 flag（比如 MSVC 用户必须开 /std:c++20） - 避免硬编码
-std=c++20：它绕过 CMake 的特性检测机制，导致跨平台时 GCC/Clang/MSVC 行为不一致
特别注意：GCC 11+ 对 cxx_concepts 的支持需配合 -fconcepts，但 CMake 的 target_compile_features 不会自动加这个 flag，必须手动补。
install() + export() 时 target_* 设置为何总失效？
本地构建没问题，install 后下游 find_package(MyLib) 却提示找不到头文件或链接失败，大概率是 install(TARGETS ... EXPORT ...) 没同步导出 INTERFACE_INCLUDE_DIRECTORIES 或 INTERFACE_LINK_LIBRARIES。
必须显式导出接口属性：
install(TARGETS mylib
EXPORT MyLibTargets
LIBRARY DESTINATION lib
ARCHIVE DESTINATION lib
RUNTIME DESTINATION bin
)
install(EXPORT MyLibTargets
FILE MyLibConfig.cmake
NAMESPACE MyLib::
DESTINATION lib/cmake/MyLib
)
# 关键：导出头路径和链接依赖
install(DIRECTORY include/
DESTINATION include
)
# 还要确保生成的 MyLibConfig.cmake 包含 interface 属性
include(CMakePackageConfigHelpers)
configure_package_config_file(
"cmake/MyLibConfig.cmake.in"
"${CMAKE_CURRENT_BINARY_DIR}/MyLibConfig.cmake"
INSTALL_DESTINATION "lib/cmake/MyLib"
)
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/MyLibConfig.cmake"
DESTINATION "lib/cmake/MyLib"
)
最容易被忽略的是：如果 mylib 依赖 fmt::fmt，且用的是 find_package(fmt) 方式引入，那么 MyLibConfig.cmake 必须包含 find_dependency(fmt)，否则下游 find_package(MyLib) 会成功，但链接时报 undefined reference to fmt::v8 —— 因为依赖关系没随配置文件导出。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
