JSON 转 C++

相关推荐

关于 JSON 转 C++：把 JSON 数据变成可编译的 C++ 结构体

适用场景

• REST API 联调：把后端返回的 JSON 响应转成 C++ struct，配合 nlohmann::json / cpr 做强类型 HTTP 请求反序列化
• 微服务接口定义：把 gRPC / HTTP 服务的请求体示例 JSON 转成 C++ 类型，统一服务端模型定义
• 嵌入式与 IoT：把设备上报的 JSON 传感器数据转成 C++ struct，配合 ArduinoJson 或 ESP-IDF JSON Parser 解析 MQTT / HTTP 报文
• 游戏开发：把关卡配置、角色属性 JSON 转成 C++ struct，方便 Unreal Engine 或 Cocos2d-x 等引擎读取 .json 数据文件
• 金融高频交易：把交易所 JSON 接口响应（如 OKX / Binance / 雪球行情）转成 C++ struct，配合 rapidjson 做纳秒级解析
• C++ Qt 客户端：把服务端 JSON 配置转成 C++ struct，配合 QJsonObject / QJsonDocument 做 GUI 数据加载
• Boost.JSON / Boost.Beast：把 HTTP 服务的 JSON 响应转成 C++ struct，配合 Boost.JSON 做反序列化，编写 Web 后端
• 嵌入式 RTOS：把 FreeRTOS / Zephyr 系统配置 JSON 转成 C++ struct，配合 cJSON 做固件参数读取
• 算法 / 量化：把回测系统的 JSON 配置转成 C++ struct，便于 A/B 实验配置管理与版本回溯
• 数据库迁移：把 MongoDB / PostgreSQL 导出的 JSON 文档转成 C++ 模型，作为 cpp-httplib / libpqxx 实体字段的参考
• 音视频 / 多媒体：把 FFmpeg / GStreamer 配置 JSON 转成 C++ struct，方便媒体管线参数读取
• 仿真与建模：把仿真系统的 JSON 输入配置转成 C++ struct，统一不同子模型的输入数据格式
• 测试数据构造：把后端返回的真实 JSON fixture 转成 C++ 类型，在 Google Test / Catch2 单元测试中做结构化断言
• 日志结构化解析：把 ELK / Loki 抓取的 JSON 日志转成 C++ 类型，方便做过滤和告警规则
• 配置中心迁移：把 Apollo / Nacos / Consul 的 JSON 配置转成 C++ 类型，用于服务端配置热加载
• 跨语言协作：后端 C++ 与前端 TypeScript / Java 联调，同一份 JSON 分别转成 C++ struct 和 TS interface / Java POJO 保持两端一致
• 教学与培训：C++ 课程中把示例 JSON 转成 struct，演示 nlohmann::json 反序列化过程和模板元编程概念
• 字段命名转换：把 snake_case 的 JSON API 响应转成 C++ 结构体后，手动添加 NLOHMANN_DEFINE_TYPE_INTRUSIVE 做字段映射

使用方法

1. 在左侧编辑器粘贴 JSON 内容（推荐 JSON 对象），或点击上传按钮选择 .json / .txt 文件
2. 工具使用 quicktype-core 通过 Web Worker 在 400ms 内自动转换，右侧显示带 std::string / std::vector<T> / 嵌套 class 的 C++ 头文件代码
3. 如 JSON 格式错误会显示红色提示，点击「修复 JSON」按钮自动修复尾随逗号、单引号等常见问题后重试
4. 检查生成的 struct / class 名称、字段类型是否符合预期；如需调整可修改源 JSON 的 key 名再重新转换
5. 点击「复制」将代码粘贴到 IDE 的 .h / .hpp 文件中，配合 nlohmann/json 或 rapidjson 反序列化真实 API 响应；或点击「下载」保存为 model.h / model.hpp

功能特点

• 本地浏览器转换：JSON 解析与 C++ 代码生成全部在浏览器内通过 Web Worker + quicktype-core 完成，原始数据不上传任何服务器
• nlohmann::json 风格输出：自动生成 std::string / std::vector<T> / double / int64_t / bool 等 STL 类型结构体，贴近 nlohmann::json 反序列化习惯，可直接 include <nlohmann/json.hpp> 解析
• rapidjson 兼容：生成的纯 C++ struct 不依赖任何第三方库，配合 rapidjson Document / GenericValue 即可用于高性能解析场景
• 自动类型推断：JSON 字符串映射 std::string，整数映射 int64_t / long long，浮点映射 double，布尔映射 bool，数组映射 std::vector<T>，嵌套对象映射独立 class / struct
• 嵌套对象自动拆分：嵌套 JSON 自动生成独立 class / struct（PascalCase 命名），避免同一类型重复定义
• std::vector 与 std::optional 自动处理：JSON 数组转 std::vector<T>，可能为 null 的字段转 std::optional<T> 兜底，符合现代 C++17 / C++20 实践
• 400ms 防抖自动转换：粘贴 JSON 后自动触发转换，右侧实时预览 C++ 头文件代码，减少等待和多余点击
• JSON 错误一键修复：自动修复尾随逗号、单引号、缺引号等常见格式错误，修复成功后继续生成代码
• 代码高亮 + 一键复制：右侧 CodeMirror 渲染 C++ 语法高亮，一键复制整个头文件，或下载为 .h / .hpp 文件直接放入工程
• localStorage 输入历史 + 响应式分栏：自动保存最近输入，刷新或误关页面后可快速恢复；左侧粘贴 JSON，右侧查看 C++ 代码，支持拖拽调整面板宽度，适配大屏和移动端
• 零依赖 header-only 产物：生成的 .h / .hpp 是 header-only 形式，可单文件 include 进任意标准 C++ 项目，无需额外构建配置即可与 nlohmann::json / rapidjson / Boost.JSON 配合使用
• snake_case 转 camelCase 内置：可把 JSON 中 snake_case 字段自动转为 C++ 推荐的 camelCase 字段名，配合 NLOHMANN_DEFINE_TYPE_INTRUSIVE 保持 snake_case 序列化映射

代码示例

// model.hpp（由本工具生成）
// #pragma once
// #include <cstdint>
// #include <optional>
// #include <string>
// #include <vector>
// struct Address {
//   std::string city;
//   std::string zip;
// };
// struct User {
//   int64_t id;
//   std::string name;
//   std::optional<Address> address;
//   std::vector<std::string> tags;
// };

#include <nlohmann/json.hpp>
#include "model.hpp"

using nlohmann::json;

int main() {
    std::string raw = R"({
        "id": 1,
        "name": "Alice",
        "address": { "city": "Beijing", "zip": "100000" },
        "tags": ["cpp", "nlohmann"]
    })";

    // 1) 解析 JSON 字符串
    json j = json::parse(raw);

    // 2) 强类型反序列化为本工具生成的 struct
    User u = j.get<User>();

    // 3) 访问字段
    std::cout << u.name << " lives in "
              << (u.address ? u.address->city : "unknown")
              << std::endl;

    for (const auto& tag : u.tags) {
        std::cout << "tag: " << tag << std::endl;
    }
    return 0;
}

/*
 * 编译（CMake 项目）：
 *   find_package(nlohmann_json REQUIRED)
 *   target_link_libraries(my_app PRIVATE nlohmann_json::nlohmann_json)
 * 编译（vcpkg）：
 *   vcpkg install nlohmann-json
 * 单文件集成：
 *   直接下载 https://github.com/nlohmann/json/releases 的 json.hpp
 */

#include "rapidjson/document.h"
#include "rapidjson/stringbuffer.h"
#include <iostream>
#include "model.hpp"

int main() {
    const char* raw = R"({
        "id": 1,
        "name": "Alice",
        "address": { "city": "Beijing", "zip": "100000" },
        "tags": ["cpp", "rapidjson"]
    })";

    // 1) rapidjson DOM 解析
    rapidjson::Document doc;
    doc.Parse(raw);

    // 2) 构造本工具生成的 struct 并手动填充
    User u;
    u.id = doc["id"].GetInt64();
    u.name = doc["name"].GetString();

    if (doc.HasMember("address") && doc["address"].IsObject()) {
        Address addr;
        addr.city = doc["address"]["city"].GetString();
        addr.zip  = doc["address"]["zip"].GetString();
        u.address = addr;
    }

    for (auto& tag : doc["tags"].GetArray()) {
        u.tags.push_back(tag.GetString());
    }

    // 3) 使用填充后的 struct
    std::cout << u.name << ", tags=" << u.tags.size() << std::endl;
    return 0;
}

/*
 * rapidjson 高性能小贴士：
 *   ① 配合 rapidjson::MemoryPoolAllocator 与 StringBuffer 可进一步提速；
 *   ② 高频场景可使用 SAX 风格的 Reader / Writer 直接流式处理；
 *   ③ 启用 RAPIDJSON_SSE42 / RAPIDJSON_SIMD 宏可使用 CPU SIMD 指令加速。
 */

#include <nlohmann/json.hpp>
#include <string>
#include <cstdint>

// 假设本工具生成字段为 snake_case：user_name, created_at
// 实际工程中重命名为 camelCase 时添加如下宏
struct UserProfile {
    int64_t id;
    std::string userName;       // JSON 中是 "user_name"
    std::string emailAddress;   // JSON 中是 "email_address"
    std::string createdAt;      // JSON 中是 "created_at"
};

// 用 NLOHMANN_DEFINE_TYPE_INTRUSIVE 在类内部声明映射
// 注意：必须放在 public 区域
// 
// NLOHMANN_DEFINE_TYPE_INTRUSIVE(UserProfile, id, userName, emailAddress, createdAt)

// 或者用非侵入式宏（避免修改类本身）：
NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(UserProfile, id, userName, emailAddress, createdAt)

// 用法：
int main() {
    nlohmann::json j = {
        {"id", 1},
        {"user_name", "Alice"},
        {"email_address", "alice@example.com"},
        {"created_at", "2026-07-14T10:00:00.000Z"}
    };

    UserProfile p = j.get<UserProfile>();
    // 序列化时也会按原字段名输出
    std::cout << j.dump(2) << std::endl;
    return 0;
}

/*
 * 提示：
 *   ① 侵入式宏（NLOHMANN_DEFINE_TYPE_INTRUSIVE）必须放在 public 区域；
 *   ② 非侵入式宏（NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE）定义在类外；
 *   ③ 字段顺序要与宏参数严格一致；
 *   ④ 日期字段可改用 nlohmann::json 自定义 adl_serializer 处理 ISO 8601 格式。
 */

最佳实践

常见问题

故障排查

术语表

struct / class

C++ 中用于定义复合数据类型的关键字。本工具生成的即为 struct，例如 struct User { int64_t id; std::string name; }。C++ 中 struct 与 class 几乎等价（默认访问权限不同：struct 成员默认 public，class 成员默认 private），工具默认生成 struct。在反序列化场景下，使用 struct 更简洁直观；如需封装私有成员 + 访问器方法，可手动改为 class。

std::string

C++ 标准库的字符串类型（所有权语义），定义在 <string> 中。本工具把 JSON 字符串字段自动映射为 std::string，例如 std::string name。注意 std::string 与 C 语言 char* / char[] 不同：std::string 自动管理内存、支持运算符重载（+、==、<），但只在处理小到中等长度字符串时性能最佳；超长字符串（如日志整行 1KB+）建议改用 std::string_view 或自定义 buffer。

std::vector<T>

C++ 标准库的动态数组容器（<vector>），等价于 Java 的 ArrayList、Python 的 list、JavaScript 的 Array。本工具把 JSON 数组字段自动映射为 std::vector<T>，如 std::vector<std::string> tags。优势：连续内存、随机访问 O(1)、尾部追加 O(1) 摊销；劣势：中间插入 O(n)。需要固定大小数组时可用 std::array<T, N>（栈上分配）。

std::optional<T>

C++17 起标准库的可选值包装类型（<optional>），表示值可能不存在。典型用法：std::optional<std::string> nickname; if (nickname) { use(*nickname); }。本工具把可能为 null 的 JSON 字段映射为 std::optional<T>，例如 std::optional<std::string> nickname。如果你的项目必须使用 C++11/14，可替换为 boost::optional<T>，API 几乎一致。

int64_t / double

int64_t 是 <cstdint> 中固定宽度的 64 位整数类型别名，等价于 long long，跨平台保证 8 字节。double 是 C++ 的双精度浮点类型（IEEE 754 双精度 / binary64，约 15-17 位有效数字）。本工具把 JSON 整数统一映射为 int64_t、浮点数统一映射为 double，避免跨平台 long 大小不一致（Windows long 为 32 位，Linux long 为 64 位）导致的精度问题。需要精确浮点（财务计算）可用 long double 或 decimal 库。

nlohmann::json

C++ 生态中最流行的 JSON 库之一，又称 nlohmann/json，由德国 nlohmann 发布，作者为 Niels Lohmann。它的核心思想是把 JSON 数据结构映射为 C++ 标准库类型（如 std::map、std::vector、std::string），反序列化时可通过 j.get<T>() 一行完成。本工具生成的代码可与 nlohmann/json 配合，使用 NLOHMANN_DEFINE_TYPE_INTRUSIVE、NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE 等宏实现自动反序列化。单头依赖、文档丰富、API 与 STL 风格一致，是大多数 C++ 项目的首选。

rapidjson

腾讯开源的高性能 JSON 库（C++），代码量约 5k 行，性能约为 nlohmann::json 的 3-5 倍。支持 SAX（流式）和 DOM（文档对象模型）两种解析风格，对 SIMD 指令（如 SSE42）有专门加速实现。典型场景：金融交易行情推送、游戏引擎对象序列化、嵌入式高性能日志。本工具生成的 struct 可作为 rapidjson Document / GenericValue 反序列化的目标模型，但因 rapidjson 无模板反射，需手动 GetObject / GetString 提取字段。

Web Worker / quicktype-core

Web Worker 是浏览器提供的后台线程 API，与主线程并行执行，不能访问主线程的 DOM，只能通过 postMessage 通信。quicktype-core 是开源的 JSON → 多语言代码生成器库（GitHub: quicktype/quicktype），支持 C++/Java/TypeScript/Rust/Go/Python/Swift 等十余种语言。本工具基于 quicktype-core 在浏览器本地为 C++ 渲染 header-only 结构体代码，原始数据不上传到任何服务器，所有解析、生成、下载均在浏览器内完成。Worker 加载 quicktype-core 避免阻塞 UI 主线程。

snake_case / camelCase / PascalCase

三种主流的字段命名风格：snake_case（user_name，C / Python / DB 首选）、camelCase（userName，Java / JS 首选）、PascalCase（UserName，C# / Rust struct 字段首选）。本工具默认保持 JSON 原字段名（一般是 snake_case），你可在生成后手动调整并添加 NLOHMANN 宏声明映射。注意 C++ 公有字段命名规范推荐 camelCase 或 snake_case，PascalCase 主要用于类名（Google C++ Style）、不推荐用于成员；snake_case 与 mySQL 列名天然兼容。

NLOHMANN_DEFINE_TYPE_INTRUSIVE

nlohmann/json 库提供的宏，用于在类内部声明 JSON 序列化字段映射。语法为 NLOHMANN_DEFINE_TYPE_INTRUSIVE(ClassName, member1, member2, ...)，必须放在 public 区域（要让宏访问私有字段）。非侵入式版本 NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE 放在类外，无需修改类本身。本工具生成的 struct 不自动添加此类宏，需要时手动添加以声明 JSON key 与 C++ 成员的对应关系。如果 JSON 字段名与 C++ 成员同名，可省略此宏直接 j.get<T>()。

JSON 类型到 C++ 类型映射速查表

工具根据 JSON 值的类型自动推断对应的 C++ 类型：

常用 C++ JSON 解析器选型对比表

C++ 生态中主流的 JSON 解析库对比，根据项目需求选择：

常见 C++ 标准库类型与 JSON 对应速查表

C++ 标准库中与 JSON 字段对应的核心类型一览，便于开发者快速查阅：

Privacy & Security

本 JSON 转 C++ 工具所有操作完全在你的浏览器本地完成：JSON 解析、C++ 结构体生成、文件下载全部通过浏览器 JavaScript（Web Worker + quicktype-core）在客户端执行，不会通过网络向任何服务器发送 JSON 内容、上传的文件或生成的代码。文件上传使用浏览器原生 FileReader API 直接读取到内存，不经过任何中间服务。不使用 Cookie 追踪，不收集任何用户输入或使用数据。关闭或刷新页面后，所有输入和输出内容自动从内存清除。适合处理含 API 密钥、token、敏感业务数据的 JSON。

Authoritative References

• nlohmannnlohmann/json GitHub 仓库（nlohmann/json）
• cppreferencecppreference - std::optional
• cppreferencecppreference - std::vector
• TencentRapidJSON GitHub 仓库（Tencent）
• BoostBoost.JSON 官方文档
• ISO C++ISO C++ 官方标准 - isocpp.org