C++处理JSON文件用什么库？快速入门指南-C++-PHP中文网

C++处理JSON文件用什么库？快速入门指南

P粉602998670

发布： 2025-08-18 08:13:01

原创

445人浏览过

nlohmann/json被广泛使用的原因包括：①单头文件无需编译，直接包含即可使用；②语法简洁直观，类似#%#$#%@%@%$#%$#%#%#$%@_23eeeb4347bdd26bfc++6b7ee9a3b755dd和javascript；③支持c++11及以上标准，适配现代c++项目；④社区活跃、文档完善，问题易解决。安装方式主要有两种：①通过vcpkg或conan等包管理器安装；②从github下载json.hpp文件并加入项目。读写json文件流程简单：①写入时用ofstream结合j.dump(4)格式化输出到文件；②读取时用ifstream加载文件内容到json对象，并可通过j["key"]访问字段，建议先判断字段是否存在。注意事项包括：①类型不匹配可能导致崩溃，应使用try-catch处理异常；②确保文件为utf-8编码以避免中文乱码；③嵌套结构可层层访问，如j"user"["city"]；④可通过重载to_json()和from_json()实现自定义类的序列化。

C++处理JSON文件用什么库？快速入门指南

在C++中处理JSON文件，最常用的库是 nlohmann/json。它是一个轻量级、功能齐全的JSON库，完全用C++编写，使用起来非常方便，尤其适合现代C++项目。

为什么选 nlohmann/json？

这个库有几个显著优点：

头文件仅需一个：不需要编译，直接包含即可使用。
语法简洁直观：和Python、JavaScript处理JSON的方式很像。
支持C++11及以上标准：如果你的项目已经用了现代C++，它能很好地融入。
社区活跃、文档完善：遇到问题容易找到答案。

如果你只是想快速读写JSON数据，这个库基本能满足需求。

立即学习“C++免费学习笔记（深入）”；

如何安装和引入？

因为这是一个纯头文件库，所以不需要额外编译安装。你可以通过以下几种方式获取：

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

使用包管理器（如vcpkg或conan）安装
直接从GitHub下载
```
json.hpp
```
登录后复制
文件并加入项目

举个简单的例子：

#include <iostream>
#include <fstream>
#include "json.hpp"  // 把下载好的json.hpp放在这儿

int main() {
    // 创建一个JSON对象
    nlohmann::json j;
    j["name"] = "Alice";
    j["age"] = 25;

    // 转成字符串输出
    std::cout << j.dump(4) << std::endl;  // 格式化缩进4格输出
}

登录后复制

这样就可以开始构造JSON数据了。

怎么读写JSON文件？

操作流程其实很简单，主要就是把文件内容加载到JSON对象里，或者反过来。

写入JSON文件：

std::ofstream o("output.json");
o << j.dump(4);  // 把上面定义的j写进去，并格式化

登录后复制

读取JSON文件：

std::ifstream i("input.json");
nlohmann::json j;
i >> j;  // 自动解析内容

// 取值也很简单
std::string name = j["name"];
int age = j["age"];

登录后复制

注意几点：

文件路径要正确，否则会读空
JSON结构要匹配访问方式，比如数组要用
```
[]
```
登录后复制
索引
如果字段可能不存在，建议先判断
```
if (j.contains("key"))
```
登录后复制

常见问题和小技巧

类型不匹配导致崩溃：比如试图从字符串字段读出整数，程序可能会抛异常。可以加try-catch避免。
中文乱码问题：默认是UTF-8编码，确保你的JSON文件也是UTF-8保存。
嵌套结构处理：可以层层访问，例如
```
j["user"]["address"]["city"]
```
登录后复制
自定义类序列化：可以通过重载
```
to_json()
```
登录后复制
和
```
from_json()
```
登录后复制
方法来实现自己的类与JSON互转。