CMake中使用add_subdirectory引入nlohmann_json时出现链接失效及头文件报错

问题根因 #

CMake的target编译环境是独立隔离的，每个编译目标的头文件搜索路径不会自动共享。
你当前的配置仅将nlohmann_json链接到了最终的main可执行程序，没有给实际使用nlohmann头文件的Example静态库关联对应依赖。编译Example.cpp时，预处理器在配置的搜索路径中找不到<nlohmann/json.hpp>，直接触发fatal error。
这种报错和后续main阶段的链接配置无关——编译流程会先完成Example库的编译，在这一步就已经中断了，哪怕main配置了nlohmann的路径也无法生效。 #

修正方案 #

调整target的依赖关联，给Example库添加nlohmann_json的链接规则，使用官方提供的标准化导入目标nlohmann_json::nlohmann_json，修改后的顶层CMakeLists.txt核心内容如下：

cmake_minimum_required(VERSION 3.0.0)
project(MWE VERSION 0.1.0)

# 启用C++17标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 引入本地nlohmann_json源码目录
add_subdirectory(nlohmann_json)

# 编译Example静态库
add_library(Example STATIC Example.cpp Example.hpp)
# 以PUBLIC作用域给Example链接nlohmann_json：
# - 保证Example自身编译时能找到对应的nlohmann头文件
# - 自动把nlohmann的头文件路径传递给所有链接Example的上层目标，无需重复配置
target_link_libraries(Example PUBLIC nlohmann_json::nlohmann_json)

# 编译主程序
add_executable(main main.cpp)
# main仅需链接Example即可，nlohmann的依赖会自动传递
target_link_libraries(main PRIVATE Example)

常见配置误区 #

• 不要尝试把nlohmann_json直接挂在main的链接列表上解决问题：编译是按target顺序执行的，Example库的编译阶段远早于main，这个配置完全覆盖不到Example的编译环境。
• 链接作用域要匹配代码使用场景：如果模块的头文件中直接引入了第三方库的头文件，给第三方库设置PUBLIC链接作用域是最低维护成本的选择，能避免所有包含该模块头文件的上层代码出现重复的头文件找不到问题。

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