如何正确配置nlohmann使cmake能够使用find_package 查找并编译？

最新推荐文章于 2025-07-08 11:37:23 发布

原创最新推荐文章于 2025-07-08 11:37:23 发布 · 4.5k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#json #c++

linux 专栏收录该内容

4 篇文章

订阅专栏

博客介绍了C++项目的操作流程，包括下载源代码，创建build目录并进行编译，接着完成安装部署，最后说明了在CMakefile.txt中的引用方法。

1.下载源代码

  git clone https://github.com/nlohmann/json.git

2.创建build目录并编译：

cd json
mkdir build
cd build/
cmake ..
make

3.安装部署

make install

4.在 CMakefile.txt 中引用，如：

find_package(nlohmann_json 3.6.0 REQUIRED)
target_link_libraries(main.exe nlohmann_json::nlohmann_json)

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

sinat_32065311

关注关注

3
点赞
踩
11

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

CMake教程：C++ CMake自定义find_package并在其它项目使用

琅嬛福地

07-22

1396

find_package 是 CMake 中一个非常重要的命令，用于在系统中找到外部库或包，并将其包含到项目中。: 要查找的包的名称。[version]: 可选的版本号。如果指定了版本号，CMake 会尝试找到该版本或更高版本的包。[REQUIRED]: 如果指定了这个关键字，找不到包时会产生一个错误并终止配置过程。: 指定要查找的包的组件。: 指定可选的组件，即使找不到这些组件，配置过程也会继续。: 指定查找包的模式，CONFIG表示查找配置文件，MODULE表示查找模块文件。

【开源分享】nlohmann C++ JSON解析库

汽车电子软件领域知识分享

01-16

1960

Nlohmann JSON 是一个用于 C++ 的现代 JSON 库，由 Niels Lohmann 开发。它以易用性和高性能著称，支持 C++11 及以上标准。

参与评论您还未登录，请先登录后发表或查看评论

nlohmann_json_cmake_fetchcontent:用于nlohmannjson的轻量级发行跟踪存储库。适用于 CMake fetchcontent。每周自动升级

05-30

nlohmann/json 的发布跟踪存储库此存储库基于：。目标是提供一个轻量级存储库，跟踪每个版本，与 cmake 兼容。你可以依赖它使用：示例： include (FetchContent) FetchContent_Declare(json GIT_REPOSITORY https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent GIT_TAG v3.9.1) FetchContent_GetProperties(json) if ( NOT json_POPULATED) FetchContent_Populate(json) add_subdirectory ( ${json_SOURCE_DIR} ${json_BINARY_DIR} EXCLUDE_FROM_ALL

C++编译时引入json/nlohmann文件报错

Ricardo的博客

06-28

1466

【代码】C++编译时引入json/nlohmann文件报错。

C++使用nlohmann的简单示例

russle的专栏

07-29

1717

备注本文展示一个使用nlohmann的简单示例，仅供参考，这是示例代码，非常简略，只是为了初学者方便学习使用。本示例使用CLion创建工程，直接在工程代码中引入nlohmann，将其放在本工程的中。

c++开源项目nlohmann/json快速上手

最新发布

愚公

07-08

954

cmake find_package

cmake中的find_package()

让代码改变世界

08-16

1306

是当在编译一个库或者可执行文件的时候，可能需要使用其他库或者头文件。但正式的项目这样肯定是不行的，一是库太多，要挨个指定太麻烦。二是一些三方库，你根本不知道它的安装路径，也不知道库的名字，所以就有了库管理的机制。

cmake交叉编译find_package(xxx)怎么处理

gggi520的博客

07-18

465

交叉编译的时候指定 OpenSSL 的路径。

CMake中指定find_package（）包的路径的方法

weixin_45533366的博客

08-16

1036

选项都是用于指定查找库和包的路径，但它们的用途和优先级有所不同。推荐使用场景：当你有自定义的查找模块或需要使用特定的 Find 模块时，可以使用这个变量。用途：用于指定查找包时的前缀路径。用途：用于指定交叉编译时的查找根路径。推荐使用场景：当你有多个安装位置或需要指定特定的库路径时，可以使用这个变量。推荐使用场景：在进行交叉编译时，指定目标平台的库和头文件路径。用途：用于指定 CMake 模块的查找路径，主要是用于查找。：用于指定查找包时的路径，优先级高于默认路径，但低于。中的路径会被优先考虑。

C++json库——nlohmann-json

czw

12-16

5180

CJSON简单介绍。

nlohmann/json怎么使用

SmileHergo的博客

07-05

555

因为它是 header-only（不需要编译链接），只要你能 #include 到它，它就能用了。是的，✅ 最直接、简单的方式就是把 json.hpp 放进你的项目里使用。❗ 结论：是的，你需要把 json.hpp 拷贝进项目里或用包管理器引入。✅ 使用 nlohmann/json 的 3 种方式（推荐顺序）✅ 方式 2：放入 include/ 目录（适合大项目）✅ 方式 1：手动放入项目目录（最常用，适合所有项目）✅ 方式 3：用包管理器（适合用 CMake 的人）

find_package()的使用

麦峰强的博客

01-03

1668

Config模式下的查找顺序，比Module模式下要多得多。根据cmake官方文档可以知道，find_package()有Module模式(基本用法，basic signature)和Config模式(full signature，完全用法），其中Module模式是基础，Config模式则更复杂高级些。前面提到说“如果Module模式查找失败则回退到Config模式进行查找”，但是假如设定了MODULE选项，那么就只在Module模式查找，如果Module模式下查找失败并不回落到Config模式查找。

C++ 之 nlohmann::json 一个不错的json库

enjoy.day

08-17

3796

nlohmann::json实践

使用c++版本nlohmann::json库快速写入、读取json文件

蜉蝣的博客

05-17

5961

nlohmann::json库本身提供了一些宏，能够实现快速实现序列化、反序列化的json目的。

nlohmann json：安装

风静如云的博客

03-01

7677

2.set(JSON_BuildTests_INIT ON)修改为set(JSON_BuildTests_INIT OFF)安装完成后可以通过引入头文件#include "nlohmann/json.hpp"来使用nlohmann json。这样修改后，将不会编译test目录下的程序，但是安装完成后，还是可以正常的使用nlohmann json编写程序。而安装好的头文件通常位于：/usr/local/include/nlohmann/nlohmann json是C++使用json的开源库，使用起来很方便。

C++中JSON文件处理教程：nlohmann/json库实战

weixin_35706255的博客

06-28

2453

nlohmann/json是一个流行的C++库，用于处理JSON数据格式。它被设计为简单、灵活且功能强大，广泛用于C++项目中。库的主要特点和优势包括：单一头文件：nlohmann/json库仅需包含一个头文件，无需编译或安装步骤，便于集成和使用。零外部依赖：库不依赖于其他库，简化了部署和分发。异常安全：库支持异常处理，确保了在发生错误时能够安全地清理资源。一致的接口：库提供了简洁的接口，使得JSON操作直观且容易记忆。支持C++11特性。

Qt通过C++使用nlohmann实现json反序列化

xiao_xiong_的博客

05-22

690

vcpkg.json内容。

cmake中，find_package查找包的路劲如何查看和设置？

06-14

<think>我们正在解决CMake中find_package查找gRPC和protobuf依赖的问题。根据用户提供的引用和问题，我们需要关注如何设置CMake的查找路径以及解决依赖配置。关键点：1.引用[1]和[3]展示了在CMakeLists.txt中正确查找protobuf和gRPC的配置方法，使用CONFIG模式。2.引用[2]展示了链接时需要同时链接gRPC和protobuf的库。3.引用[4]提到了交叉编译时设置查找路径的方法。4.引用[5]是关于gRPC和protobuf生成代码的路径设置。用户需求：查找CMake中find_package查找包的路径查看和设置方法，解决gRPC和protobuf相关依赖问题。解决方案步骤：一、理解find_package的查找机制find_package有两种模式：MODULE模式和CONFIG模式。我们通常使用CONFIG模式，因为它通过<PackageName>Config.cmake文件来定位包。二、设置查找路径1.通过设置CMAKE_PREFIX_PATH环境变量或CMake变量来增加查找路径。例如：将protobuf和gRPC的安装路径添加到CMAKE_PREFIX_PATH中。2.设置特定的<PackageName>_DIR变量，指向包含<PackageName>Config.cmake的目录。三、解决gRPC和protobuf依赖问题的具体步骤步骤1：确保protobuf和gRPC已正确安装，且版本兼容。步骤2：在CMakeLists.txt中正确设置查找顺序和模式（如引用[1]所示）：先查找protobuf（使用CONFIG模式），再查找gRPC（使用CONFIG模式）。步骤3：设置路径变量（如果安装在不标准的位置）：-在命令行中传递变量：cmake-DProtobuf_DIR=/path/to/protobuf/cmake-DgRPC_DIR=/path/to/grpc/cmake...-或在CMakeLists.txt中设置：set(Protobuf_DIR"/path/to/protobuf/cmake")set(gRPC_DIR"/path/to/grpc/cmake")步骤4：处理交叉编译情况（参考引用[4]）：在交叉编译时，可能需要调整CMAKE_FIND_ROOT_PATH_MODE_PROGRAM等变量。步骤5：链接库（参考引用[2]）：在target_link_libraries中同时链接gRPC和protobuf的库。四、查看find_package的查找路径和结果可以在CMakeLists.txt中添加消息打印来查看找到的路径：message(STATUS"Protobuffoundat:${Protobuf_DIR}")message(STATUS"gRPCfoundat:${gRPC_DIR}")也可以在运行cmake时添加--debug-find选项查看详细查找过程：cmake--debug-find...示例CMakeLists.txt配置：```cmakecmake_minimum_required(VERSION3.15)project(MyProject)#设置protobuf_MODULE_COMPATIBLE为TRUE，以便兼容旧版protobufset(protobuf_MODULE_COMPATIBLETRUE)#查找Protobuf（使用CONFIG模式）find_package(ProtobufCONFIGREQUIRED)message(STATUS"FoundProtobuf:${Protobuf_VERSION}")#查找gRPC（使用CONFIG模式）find_package(gRPCCONFIGREQUIRED)message(STATUS"FoundgRPC:${gRPC_VERSION}")#添加可执行文件add_executable(my_appmain.cpp)#链接库target_link_libraries(my_appPRIVATEgRPC::grpc++#gRPCC++库gRPC::grpc++_reflectionprotobuf::libprotobuf#protobuf库)#如果有.proto文件，还需要生成代码（参考引用[2]和[5]）```五、常见问题处理1.如果出现gRPCConfig.cmake找不到protobuf，可能是因为protobuf的Config文件没有被找到。确保Protobuf_DIR设置正确。2.交叉编译时，设置CMAKE_FIND_ROOT_PATH_MODE_PROGRAM为NEVER，然后再设置回ONLY（如引用[4]）。六、环境变量设置除了在CMake中设置变量，还可以通过环境变量设置查找路径：exportCMAKE_PREFIX_PATH=/path/to/protobuf:/path/to/grpc:$CMAKE_PREFIX_PATH或者分别设置：exportProtobuf_DIR=/path/to/protobuf/cmakeexportgRPC_DIR=/path/to/grpc/cmake七、验证安装在安装目录下，应该存在对应的Config.cmake文件。例如：/usr/local/lib/cmake/protobuf/protobuf-config.cmake/usr/local/lib/cmake/grpc/gRPCConfig.cmake如果这些文件不在标准路径，就需要通过上述方法指定路径。八、使用包管理器（如vcpkg）如果使用vcpkg，则可以通过设置CMAKE_TOOLCHAIN_FILE来让CMake自动找到依赖。总结：关键是通过设置正确的路径变量（Protobuf_DIR和gRPC_DIR）或CMAKE_PREFIX_PATH来帮助find_package找到对应的配置文件。相关问题：1.如何查看find_package的搜索路径？2.交叉编译时如何设置find_package的查找路径？3.如何同时使用系统安装的protobuf和自定义安装的gRPC？4.如何解决gRPC和protobuf版本不兼容的问题？5.如何在CMake中生成gRPC和protobuf的代码？</think>### CMake中`find_package`路径设置与gRPC/protobuf依赖解决方案 #### 一、`find_package`路径查看与设置方法 1. **搜索路径优先级** CMake查找包的顺序为[^4][^1]： ```mermaid graph LR A[用户指定路径] --> B[CMAKE_PREFIX_PATH] B --> C[系统路径 /usr/lib /usr/local] C --> D[环境变量 PATH] ``` 2. **关键路径设置变量** | 变量名 | 作用域 | 示例值 | |------------------------|---------------|--------------------------------| | `CMAKE_PREFIX_PATH` | 全局或项目级 | `/opt/grpc:/usr/local/protobuf`| | `Protobuf_DIR` | 项目级 | `/usr/local/protobuf/lib/cmake`| | `gRPC_DIR` | 项目级 | `/opt/grpc/lib/cmake` | | `CMAKE_MODULE_PATH` | 项目级 | `${PROJECT_SOURCE_DIR}/cmake` | 3. **设置方法示例** **CMakeLists.txt中设置**： ```cmake # 设置protobuf路径 set(Protobuf_DIR "/usr/local/protobuf/lib/cmake/protobuf") # 设置gRPC路径 set(gRPC_DIR "/opt/grpc/lib/cmake/grpc") # 添加自定义模块路径 list(APPEND CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake") find_package(Protobuf REQUIRED) find_package(gRPC REQUIRED) ``` **命令行设置**： ```bash cmake -DProtobuf_DIR=/path/to/protobuf -DgRPC_DIR=/path/to/grpc .. ``` #### 二、gRPC/protobuf依赖问题解决方案 1. **正确配置依赖顺序** 在CMakeLists.txt中按顺序声明依赖[^1][^3]： ```cmake # 必须设置此标志 set(protobuf_MODULE_COMPATIBLE TRUE) # 先查找protobuf find_package(Protobuf CONFIG REQUIRED) message(STATUS "Using protobuf ${Protobuf_VERSION}") # 再查找gRPC find_package(gRPC CONFIG REQUIRED) message(STATUS "Using gRPC ${gRPC_VERSION}") ``` 2. **完整链接配置** 确保正确链接所有必要库[^2]： ```cmake target_link_libraries(your_target PRIVATE gRPC::grpc++ gRPC::grpc++_reflection protobuf::libprotobuf protobuf::libprotoc ) ``` 3. **交叉编译处理** 对于交叉编译环境[^4]： ```cmake # 临时禁用root路径模式 set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) find_package(Protobuf REQUIRED) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM ONLY) ``` #### 三、诊断工具与验证方法 1. **查看搜索路径** 在CMakeLists.txt中添加： ```cmake message(STATUS "Protobuf search paths: ${Protobuf_DIR}") get_property(proto_dirs GLOBAL PROPERTY _CMAKE_FIND_PACKAGE_PATHS) message(STATUS "All package paths: ${proto_dirs}") ``` 2. **生成文件路径设置** 控制.proto文件的生成位置[^5]： ```cmake set(GENERATED_DIR "${CMAKE_CURRENT_BINARY_DIR}/generated") file(MAKE_DIRECTORY ${GENERATED_DIR}) set_target_properties(proto_target PROPERTIES PROTOC_OUTPUT_DIR "${GENERATED_DIR}" ) ``` 3. **环境变量覆盖** 在终端中临时覆盖： ```bash export CMAKE_PREFIX_PATH="/custom/grpc:/custom/protobuf" cmake .. ``` #### 四、最佳实践建议 1. **版本兼容性检查** 在CMakeLists.txt开头添加： ```cmake if(Protobuf_VERSION VERSION_LESS "3.15.0") message(FATAL_ERROR "Protobuf 3.15+ required, found ${Protobuf_VERSION}") endif() ``` 2. **安装路径标准化** 推荐安装路径结构： ``` /opt/grpc ├── include ├── lib └── lib/cmake/grpc # 包含gRPCConfig.cmake ``` 3. **容器环境处理** 在Dockerfile中设置： ```dockerfile ENV Protobuf_DIR=/usr/local/protobuf/lib/cmake ENV gRPC_DIR=/usr/local/grpc/lib/cmake ``` > **关键提示**：当出现`gRPCConfig.cmake found but set gRPC_FOUND to FALSE`错误时，90%的原因是protobuf路径配置错误或版本不兼容。优先验证`Protobuf_DIR`是否指向包含`protobuf-config.cmake`的目录[^1][^4]。