Пока нет содержимого
Бесплатный онлайн инструмент JSON в C++. Вставьте JSON и автоматически генерируйте готовые к компиляции C++ struct / class коды заголовочных файлов, подходит для десериализации API ответов с помощью nlohmann/json или rapidjson, вложенные объекты автоматически разделяются на независимые классы, std::vector и std::optional обрабатываются автоматически, полностью локальная работа в браузере.
JSON в C++ — это процесс преобразования данных в формате JSON (объектов или массивов) в определения типов C++ struct / class. C++ — это язык программирования со строгой системой типов, широко используемый в бэкенд-сервисах, игровых движках, встраиваемых прошивках, квантовой торговле, высокопроизводительных сервисах и настольных клиентах. В разработке часто требуется преобразовывать примеры JSON из документации API или реальных ответов в типы C++, написание struct вручную не только связано с повторяющейся работой, но и легко приводит к ошибкам в типах полей, цель этого инструмента — автоматизировать этот процесс. В отличие от Java, Python, JavaScript, C++ не имеет встроенной поддержки таких динамических структур, как JSON, поэтому «JSON в C++» долгое время считался повторяющейся, но необходимой работой в инженерной среде.
Этот инструмент работает локально в браузере на основе quicktype-core, использует CPP renderer и опции рендеринга just-types для генерации кода структур на основе std::string / std::vector<T> / std::optional<T> для C++. Сгенерированный код является стандартным C++ кодом header-only, не зависит от сторонних библиотек парсинга JSON, может быть напрямую включен в любой проект C++17 / C++20. При использовании с парсерами nlohmann/json или rapidjson можно быстро завершить десериализацию ответов API. Весь процесс рендеринга выполняется асинхронно в браузере через Web Worker, основной поток остается плавным.
Вывод типов — это ядро преобразования JSON в C++. Инструмент сопоставляет базовые типы JSON со стандартными типами C++: строки с std::string, целые числа с int64_t (совместим с long long, избегая различий в размере long на разных платформах), числа с плавающей точкой с double, булевы значения с bool, массивы с std::vector<T>, вложенные объекты с независимыми struct / class, значения null с std::optional<T>. Для вложенных объектов инструмент автоматически создает новый class для каждого уровня и именует его в PascalCase, например, поле address генерирует структуру Address, объекты в массиве items генерируют структуру Item.
В отличие от некоторых онлайн-инструментов, которые требуют загрузки JSON на сервер, все вычисления этого инструмента выполняются в браузере. quicktype-core загружается и выполняется через Web Worker, парсинг JSON, вывод типов, генерация C++ кода, загрузка файлов выполняются локально, данные не отправляются на серверы. Это особенно важно для JSON, содержащего API ключи, поля с конфиденциальностью пользователей или неопубликованные бизнес-структуры, после закрытия страницы данные немедленно удаляются из памяти.
Сгенерированный код обычно используется с парсером JSON. Существует два основных варианта: ① nlohmann::json (рекомендуется, однозаголовочное включение, дружественный интерфейс сериализации шаблонов, синтаксис похож на nlohmann::json j = nlohmann::json::parse(str); User u = j.get<User>();); ② rapidjson (высокопроизводительный парсинг в стиле SAX / DOM, подходит для предельных сценариев, таких как финансы, игры, требует ручного извлечения полей через GetObject). Для встраиваемых систем также можно использовать ArduinoJson или cJSON. Код этого инструмента совместим со всеми основными библиотеками C++ JSON.
Следует отметить, что автоматически сгенерированный код — это отправная точка, а не конечный результат. Инструмент выводит типы по образцу JSON и не может определить точные бизнес-типы (например, семантические типы, такие как URL, Email, ID, все будут унифицированно выведены как std::string). Для полей JSON в snake_case поля C++ struct генерируются как есть, вам может потребоваться вручную добавить NLOHMANN_DEFINE_TYPE_INTRUSIVE или NLOHMANN_JSON_FROM / NLOHMANN_JSON_TO для объявления сопоставлений. Рекомендуется использовать сгенерированный результат как первый вариант, а затем тонко настроить имена полей, типы и аннотации сериализации в соответствии со спецификациями проекта.
В сценариях межкомандного взаимодействия JSON в C++ также является мостом для унификации моделей данных. Фронтенд использует JSON в TypeScript, бэкенд использует JSON в Java / Go / Rust, встраиваемые системы и сервисы производительности используют JSON в C++, четыре стороны используют один и тот же образец JSON для генерации своих определений типов, что может максимально гарантировать согласованность полей. Этот инструмент является «стороной C++» в этом рабочем процессе.
Одним предложением: если ваш код работает в чувствительных к производительности, строго типизированных проектах C++ с богатой экосистемой и вам нужно быстро подключить такие динамические данные, как JSON, к миру строгих типов, этот инструмент — это прямой вход для компиляции образцов JSON в структуры C++.
Поместите сгенерированную структуру User в .hpp и выполните десериализацию с nlohmann::json (рекомендуется для современных проектов C++17/20).
// 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
*/rapidjson не поддерживает автоматическую десериализацию в пользовательские struct, требуется ручное извлечение через GetObject. Подходит для высокопроизводительных сценариев, таких как финансы / игры.
#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 指令加速。
*/Когда поля JSON имеют формат snake_case, а члены C++ должны использовать camelCase / PascalCase, объявите сопоставление с помощью макросов nlohmann/json.
#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 格式。
*/Большинство команд рекомендуют сначала использовать nlohmann::json, поскольку его API похож на STL, при десериализации достаточно одной строки j.get<User>(). Переключайтесь на rapidjson только при возникновении узких мест производительности. Структуры, сгенерированные этим инструментом, могут работать с обоими.
Репозиторий nlohmann/jsonРепозиторий rapidjsonИспользование FetchContent — самый чистый способ интеграции nlohmann/json в CMake, не требует предустановки vcpkg; если не хотите настраивать FetchContent, можно использовать vcpkg или напрямую скачать json.hpp.
Документация CMake FetchContentИнструмент по умолчанию сохраняет исходные имена полей JSON (snake_case). Если вы хотите использовать camelCase или PascalCase, добавьте NLOHMANN_DEFINE_TYPE_INTRUSIVE внутри класса для явного сопоставления, иначе десериализация завершится неудачей.
Документация NLOHMANN_DEFINE_TYPE_INTRUSIVEВ C++17+ напрямую используйте std::optional<T>; в проектах C++11/14 замените на boost::optional<T>; в проектах в стиле C используйте cJSON + поля-сентинели. Обратите внимание, что интерфейсы std::optional и boost::optional немного различаются.
cppreference std::optionalНа устройствах с очень маленькой ОЗУ, таких как Arduino Uno / ESP8266, std::vector и std::string обычно вызывают OOM. Вместо этого используйте ArduinoJson 6.x + StaticJsonDocument для ограничения буфера и замените std::vector<T> на std::array<T, N> фиксированного размера.
Документация ArduinoJsonВесь парсинг, генерация кода и загрузка файлов этого инструмента полностью выполняются локально в браузере через Web Worker, исходный JSON не загружается на серверы. Но все же рекомендуется: ① сначала обезличивайте внутренние бизнес-модели; ② закрывайте страницу, чтобы очистить память; ③ в сценариях соответствия требованиям крупных компаний используйте локальный quicktype.
JSON с уровнем вложенности более 6 слоев рекомендуется реструктурировать на стороне источника, или после генерации вручную разделите глубокую вложенность на промежуточные структуры для улучшения читаемости и скорости компиляции. Глубокая вложенность может привести к чрезмерной глубине инстанцирования шаблонов.
Код, сгенерированный этим инструментом, по сути является C++ (использует функции C++, такие как std::optional / template), рекомендуется использовать суффикс .hpp для обозначения «C++ header», чтобы отличить от .h заголовков C.
Спецификация суффиксов GCCРаспознавание типов CMakeВставьте содержимое JSON в левый редактор (также поддерживается перетаскивание или нажатие для загрузки файлов .json / .txt), инструмент автоматически вызовет quicktype-core локально в браузере в течение 400 мс для генерации кода заголовочного файла C++; в правой области CodeMirror отображается код структуры с std::string / std::vector<T> / вложенными class. Если формат JSON неверен, нажмите кнопку «Исправить JSON» для автоматического исправления перед преобразованием.
Инструмент выводит код структур header-only, зависящий только от стандартной библиотеки C++ (<string>, <vector>, <optional>, <cstdint>). При парсинге с nlohmann/json дополнительно требуется #include <nlohmann/json.hpp>; при парсинге с rapidjson требуется #include "rapidjson/document.h". Остальные стандартные заголовки инструмент объявляет по мере необходимости.
Поддерживаются все допустимые структуры JSON: базовые типы (null, boolean, number, string), массивы (одномерные или многомерные), вложенные объекты (любой глубины). Объекты JSON генерируют корневой struct / class, массивы JSON появляются как std::vector<T> в некотором поле верхней структуры. Не поддерживаются специфичные для JavaScript значения, такие как литералы объектов, функции, Symbol, undefined и т. д.
Строки сопоставляются с std::string; целые числа с int64_t (также часто long long для совместимости со старым кодом); числа с плавающей точкой с double; булевы значения с bool; массивы с std::vector<T>; вложенные объекты с независимыми struct / class; значения null с std::optional<T> (может использоваться nlohmann::json в качестве резервного варианта). Подробные правила сопоставления см. в «Таблице быстрого сопоставления типов JSON с типами C++» внизу страницы.
Значения null в JSON генерируют std::optional<T> (доступно с C++17), указывая, что поле может отсутствовать или иметь неопределенный тип. Если вы уже знаете фактический тип поля, вы можете указать пример значения в исходном JSON (например, "field": "" выводится как std::string), а после генерации изменить на более точный тип, такой как std::optional<std::string>, в соответствии с бизнес-требованиями.
Да. Массивы JSON унифицированно преобразуются в контейнеры шаблонов C++ std::vector<T>, тип элемента автоматически выводится по первому элементу массива. Например, ["a","b"] генерирует std::vector<std::string>, [1,2,3] генерирует std::vector<int64_t>, [{...},{...}] генерирует std::vector<Item> (Item - независимая struct, сгенерированная по вложенному объекту).
Каждый вложенный объект генерирует независимый struct / class, правила именования - PascalCase по имени поля (например, поле address генерирует структуру Address, объекты в массиве items генерируют структуру Item). Корневая структура ссылается на вложенные классы через члены типа std::optional<Address> или Address. Объекты с одинаковой структурой повторно используют один и тот же тип, избегая повторных определений.
Да. Пример типичного использования: nlohmann::json j; j["root"] = nlohmann::json::parse(raw_json); User u = j.get<User>(); при условии, что в проект включена однозаголовочная зависимость nlohmann/json (непосредственно include <nlohmann/json.hpp>) и определена сгенерированная этим инструментом структура User.
Да. rapidjson требует ручного написания кода извлечения полей типа GetObject. Типичный путь: rapidjson::Document doc; doc.Parse(raw_json); const auto& obj = doc["root"]; std::string id = obj["id"].GetString(); поскольку rapidjson не поддерживает автоматическую десериализацию через шаблоны, сгенерированные struct служат только эталоном модели данных.
Инструмент генерирует поля C++ с сохранением исходных имен полей JSON (например, user_name). Если вы хотите, чтобы члены C++ использовали camelCase (userName) или PascalCase (UserName), вы можете вручную изменить их после генерации и добавить макросы NLOHMANN (NLOHMANN_DEFINE_TYPE_INTRUSIVE / NLOHMANN_JSON_FROM / NLOHMANN_JSON_TO) для указания сопоставления.
Да. Код, сгенерированный этим инструментом, является стандартным C++ кодом header-only, не зависит от конкретных фреймворков. При парсинге с Qt QJsonObject используйте структуры как модели данных (члены помечены Q_GADGET); при использовании с Unreal Engine используйте с FJsonObjectConverter::JsonObjectStringToUStruct; при использовании с Boost.JSON парсите JSON в boost::json::object и извлекайте поля по одному.
Полностью локальная работа в браузере. Весь парсинг JSON, генерация C++ кода и загрузка файлов полностью выполняются в браузере через JavaScript (Web Worker + quicktype-core), введенные данные JSON и сгенерированный C++ код не загружаются на какие-либо серверы, не записываются и не кэшируются в облако. Чувствительный JSON, содержащий API ключи, токены, неопубликованные бизнес-поля, можно безопасно использовать, после закрытия страницы данные очищаются.
Не требуется. Инструмент полностью бесплатный, не требует регистрации, входа или авторизации. Можно использовать сразу после открытия страницы, все функции доступны локально в браузере, без каких-либо ограничений на количество вызовов или размер файлов (в пределах памяти браузера).
Инструмент автоматически проверяет допустимость JSON, при ошибке справа отображается красное сообщение об ошибке и предоставляется кнопка «Исправить JSON». После нажатия автоматически исправляются распространенные ошибки: лишние запятые в конце, замена одинарных кавычек на двойные, дополнение кавычек для ключей без кавычек, удаление комментариев и т. д. После успешного исправления продолжается генерация C++ кода.
Все три преобразуют JSON в определения типов целевого языка, но выходные формы различаются: JSON в C++ генерирует header-only struct / class, вам нужно дополнительно написать код десериализации с nlohmann/json или rapidjson; JSON в Java генерирует полные классы POJO с getter/setter, которые можно напрямую компилировать и запускать; JSON в Rust генерирует struct с derive Serde, которые могут напрямую десериализовываться через serde_json. Выбор зависит от вашего технологического стека.
Левое поле ввода пусто или содержит только пробельные символы. Убедитесь, что вы вставили допустимое содержимое JSON, или нажмите кнопку загрузки, чтобы выбрать файл .json / .txt.
Распространенные причины: лишние запятые в конце, использование одинарных кавычек вместо двойных, ключи без двойных кавычек, наличие комментариев JavaScript. Нажмите кнопку «Исправить JSON», чтобы автоматически исправить некоторые ошибки.
Проект не использует стандарт C++17 или выше. std::optional введен в C++17. В CMakeLists.txt установите CMAKE_CXX_STANDARD на 17 или выше (set(CMAKE_CXX_STANDARD 17)); или добавьте #include <optional> и проверьте версию компилятора.
Инструмент использует int64_t из <cstdint>, требуется GCC 4.5+ / Clang 3.0+ / MSVC 2015+. Проверьте, содержит ли исходный файл #include <cstdint>, и убедитесь, что стандарт C++ установлен >= C++11.
Возможные причины: ① имена полей JSON не полностью совпадают с именами членов C++; ② вложенные объекты не обработаны правильно; ③ доступ value() к полю std::optional вызывает исключение. Решение: добавьте макрос NLOHMANN_DEFINE_TYPE_INTRUSIVE для явного сопоставления полей.
rapidjson по умолчанию не проверяет типы полей. GetString безопасен только тогда, когда поле действительно существует и имеет строковый тип. Улучшенный синтаксис: if (doc.HasMember("name") && doc["name"].IsString()) { u.name = doc["name"].GetString(); }.
Инструмент выводит типы по образцу JSON, все целые числа — int64_t, все строки — std::string. Если вам нужны более точные типы, такие как int32_t, uint64_t, std::chrono::system_clock::time_point, вручную измените типы полей после генерации.
Поскольку JSON null не может вывести конкретный тип, инструмент использует std::optional<nlohmann::json> в качестве резервного варианта. Если вы знаете фактический тип поля, вы можете указать пример значения в исходном JSON и сгенерировать снова.
Инструмент генерирует поля C++ с сохранением исходных имен полей JSON. Если вы хотите использовать camelCase и при этом правильно десериализовывать snake_case JSON, используйте макросы NLOHMANN_DEFINE_TYPE_INTRUSIVE / NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE.
Возможные причины: ① CMake не установил стандарт C++17 / C++20; ② отсутствуют заголовочные файлы; ③ имя структуры конфликтует с другими типами. Решение: добавьте set(CMAKE_CXX_STANDARD 17), добавьте соответствующие заголовки, оберните в namespace или переименуйте структуры.
Инструмент автоматически выводит соответствующие типы C++ на основе типа значений JSON:
| JSON 值示例 | 生成 C++ 类型 | Примечание |
|---|---|---|
null | std::optional<T> | Тип null неопределен, используется std::optional<T> (C++17+) |
true / false | bool | Булевы значения JSON напрямую сопоставляются с C++ bool |
42 | int64_t | Целые числа JSON по умолчанию сопоставляются с int64_t (<cstdint>), совместимы с long long |
3.14 | double | Числа с плавающей точкой JSON по умолчанию сопоставляются с double (IEEE 754) |
"hello" | std::string | Строки JSON сопоставляются с std::string (<string>) |
["a","b"] | std::vector<std::string> | Массивы строк сопоставляются с std::vector<std::string> |
[1,2,3] | std::vector<int64_t> | Массивы целых чисел сопоставляются с std::vector<int64_t> |
[{...},{...}] | std::vector<Item> | Массивы объектов генерируют struct по первому элементу, оборачиваются в std::vector |
[] | std::vector<nlohmann::json> | Пустые массивы не могут вывести тип, используется nlohmann::json в качестве резервного варианта |
{...} 嵌套对象 | 独立 struct / class | Вложенные объекты генерируют независимые struct, именование PascalCase (address → Address) |
Сравнение основных библиотек парсинга JSON в экосистеме C++, выбирайте в соответствии с потребностями проекта:
| Название | API 风格 | 性能 | Сценарии |
|---|---|---|---|
nlohmann::json | 模板 / STL-like | Средн. | Веб-бэкенды, настольные приложения, обучение |
rapidjson | SAX / DOM | Очень высок. | Финансы, игры, высокопроизводительные сервисы; SIMD |
Boost.JSON | Boost.Container | Высок. | Экосистема Boost, веб-серверы (Beast / Asio) |
cJSON | C 风格 / 函数式 | Высок. | Проекты на C, встраиваемые C++ |
ArduinoJson | C++ 模板 | Средн. | Arduino, ESP32 / ESP8266, встраиваемые MCU |
Обзор основных типов стандартной библиотеки C++, соответствующих полям JSON:
| Ключевое слово JSON | Тип C++ | Заголовок | Стандарт C++ |
|---|---|---|---|
| string | std::string | <string> | C++98 |
| integer | int64_t（<cstdint>） | <cstdint> | C++11 |
| number | double | <iostream> / <cmath> | C++98 |
| boolean | bool | <stdbool.h>(C) / 内置 | C++98 |
| null | std::optional<T> | <optional> | C++17 |
| array | std::vector<T> | <vector> | C++98 |
| array 固定 | std::array<T, N> | <array> | C++11 |
| object / map | std::map<std::string, T> | <map> | C++98 |
| object 哈希 | std::unordered_map<K, T> | <unordered_map> | C++11 |
| string view | std::string_view（不拥有数据） | <string_view> | C++17 |
| byte / char | std::byte / char | <cstddef> | C++17 / C++98 |
Все операции этого инструмента JSON в C++ полностью выполняются локально в вашем браузере: парсинг JSON, генерация структур C++, загрузка файлов — все выполняется на клиенте через JavaScript браузера (Web Worker + quicktype-core), содержимое JSON, загруженные файлы или сгенерированный код не отправляются по сети на какие-либо серверы. Загрузка файлов использует собственный API FileReader браузера для прямого чтения в память. Не использует отслеживание Cookie, не собирает никакие данные ввода или использования пользователя. После закрытия или обновления страницы все содержимое автоматически удаляется из памяти. Подходит для обработки JSON, содержащего ключи API, токены, конфиденциальные бизнес-данные.