JSON을 C++로

관련 추천

JSON to C++ 정보: JSON 데이터를 컴파일 가능한 C++ 구조체로 변환

사용 사례

• REST API 연동: 백엔드에서 반환된 JSON 응답을 C++ 구조체로 변환하여 nlohmann::json / cpr로 강력한 타입의 HTTP 요청 역직렬화
• 마이크로서비스 인터페이스 정의: gRPC / HTTP 서비스의 요청 본문 예제 JSON을 C++ 타입으로 변환하여 서버 측 모델 정의 통일
• 임베디드 & IoT: 디바이스에서 보고한 JSON 센서 데이터를 C++ 구조체로 변환하여 ArduinoJson이나 ESP-IDF JSON Parser로 MQTT / HTTP 메시지 파싱
• 게임 개발: 레벨 구성, 캐릭터 속성 JSON을 C++ 구조체로 변환하여 Unreal Engine이나 Cocos2d-x 등의 엔진에서 .json 데이터 파일 읽기 용이
• 금융 고빈도 거래: 거래소 JSON 인터페이스 응답(OKX / Binance / 설구 시세)을 C++ 구조체로 변환하여 rapidjson으로 나노초 단위 파싱
• C++ Qt 클라이언트: 서버 JSON 구성을 C++ 구조체로 변환하여 QJsonObject / QJsonDocument로 GUI 데이터 로드
• Boost.JSON / Boost.Beast: HTTP 서비스의 JSON 응답을 C++ 구조체로 변환하여 Boost.JSON으로 역직렬화하여 웹 백엔드 작성
• 임베디드 RTOS: FreeRTOS / Zephyr 시스템 구성 JSON을 C++ 구조체로 변환하여 cJSON으로 펌웨어 매개변수 읽기
• 알고리즘 / 퀀트: 백테스팅 시스템의 JSON 구성을 C++ 구조체로 변환하여 A/B 실험 구성 관리와 버전 추적 용이
• 데이터베이스 마이그레이션: MongoDB / PostgreSQL에서 내보낸 JSON 문서를 C++ 모델로 변환하여 cpp-httplib / libpqxx 엔티티 필드의 참조로 사용
• 오디오/비디오 / 멀티미디어: FFmpeg / GStreamer 구성 JSON을 C++ 구조체로 변환하여 미디어 파이프라인 매개변수 읽기 편의
• 시뮬레이션 & 모델링: 시뮬레이션 시스템의 JSON 입력 구성을 C++ 구조체로 변환하여 하위 모델 전체의 입력 데이터 형식 통일
• 테스트 데이터 구성: 백엔드 응답의 실제 JSON fixture를 C++ 타입으로 변환하여 Google Test / Catch2 단위 테스트에서 구조화된 어설션
• 구조화된 로그 파싱: ELK / Loki에서 수집한 JSON 로그를 C++ 타입으로 변환하여 필터링과 알림 규칙 용이
• 구성 센터 마이그레이션: Apollo / Nacos / Consul의 JSON 구성을 C++ 타입으로 변환하여 서버 측 구성 핫 리로드에 사용
• 크로스랭귀지 협업: 백엔드 C++가 프론트엔드 TypeScript / Java와 연동할 때, 동일한 JSON을 각각 C++ 구조체와 TS 인터페이스 / Java POJO로 변환하여 양쪽 일관성 유지
• 교육 & 훈련: C++ 강의에서 예제 JSON을 struct로 변환하여 nlohmann::json 역직렬화 과정과 템플릿 메타프로그래밍 개념 시연
• 필드 명명 변환: snake_case JSON API 응답을 C++ 구조체로 변환한 후 수동으로 NLOHMANN_DEFINE_TYPE_INTRUSIVE를 추가하여 필드 매핑

이용 방법

1. 왼쪽 편집기에 JSON 내용을 붙여넣고(JSON 객체 권장), 또는 업로드 버튼을 클릭하여 .json / .txt 파일을 선택합니다
2. 도구는 Web Worker를 통해 quicktype-core를 사용하여 400ms 이내에 자동 변환하며, 오른쪽에 std::string / std::vector<T> / 중첩 class가 포함된 C++ 헤더 코드가 표시됩니다
3. JSON 형식 오류가 있으면 빨간색 프롬프트가 표시되며, 'JSON 복구' 버튼을 클릭하여 trailing comma, 작은따옴표 등 일반적인 문제를 자동 복구한 후 재시도합니다
4. 생성된 struct / class 이름과 필드 타입이 예상과 일치하는지 확인합니다; 필요한 경우 소스 JSON의 키 이름을 수정하고 다시 변환합니다
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 역직렬화 관행에 가깝고, <nlohmann/json.hpp>를 직접 include하여 파싱할 수 있습니다
• 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 오류 원클릭 복구: trailing comma, 작은따옴표, 따옴표 누락 등 일반적인 형식 오류를 자동으로 복구하고, 복구 성공 후 코드 생성을 계속합니다
• 코드 하이라이팅 + 원클릭 복사: 오른쪽 CodeMirror에서 C++ 구문 하이라이팅을 렌더링하며, 헤더 파일 전체를 원클릭으로 복사하거나 .h / .hpp 파일로 다운로드하여 프로젝트에 직접 넣을 수 있습니다
• localStorage 입력 기록 + 반응형 분할 패널: 최근 입력을 자동 저장하여 새로고침이나 실수로 페이지를 닫은 후에도 빠르게 복구할 수 있습니다; 왼쪽에 JSON을 붙여넣고 오른쪽에서 C++ 코드를 보며, 패널 너비 드래그 조정을 지원하여 대화면과 모바일에 적응합니다
• 무의존성 header-only 결과물: 생성된 .h / .hpp는 header-only 형식으로, 표준 C++ 프로젝트에 단일 파일로 include할 수 있으며, 추가 빌드 설정 없이 nlohmann::json / rapidjson / Boost.JSON과 함께 사용할 수 있습니다
• 내장된 snake_case to 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", "a**@***********"},
        {"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 格式。
 */

Best Practices

자주 묻는 질문

문제 해결

용어집

struct / class

C++에서 복합 데이터 타입을 정의하는 데 사용되는 키워드입니다. 이 도구가 생성하는 것은 struct로, 예를 들어 struct User { int64_t id; std::string name; } 입니다. C++에서 struct와 class는 거의 동일합니다(기본 접근 권한이 다름: struct 멤버는 기본적으로 public, class 멤버는 기본적으로 private). 도구는 기본적으로 struct를 생성합니다. 역직렬화 시나리오에서는 struct를 사용하는 것이 더 간결하고 직관적입니다; private 멤버 + 접근자 메서드를 캡슐화해야 하는 경우 수동으로 class로 변경할 수 있습니다.

std::string

C++ 표준 라이브러리의 문자열 타입(소유권 의미론)으로 <string>에 정의되어 있습니다. 이 도구는 JSON 문자열 필드를 자동으로 std::string에 매핑합니다(예: std::string name). std::string은 C 언어 char* / char[]와 다릅니다: std::string은 메모리를 자동으로 관리하고 연산자 오버로딩(+, ==, <)을 지원하지만, 작거나 중간 길이의 문자열을 처리할 때 성능이 가장 좋습니다; 매우 긴 문자열(예: 로그 전체 1KB+)은 std::string_view나 사용자 정의 버퍼를 사용하는 것이 좋습니다.

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>(#include <boost/optional.hpp>)로 대체할 수 있으며 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 라이브러리 중 하나로, 독일의 Niels Lohmann이发布했습니다. 핵심 아이디어는 JSON 데이터 구조를 C++ 표준 라이브러리 타입(예: std::map, std::vector, std::string)에 매핑하는 것이며, 역직렬화 시 j.get<T>() 한 줄로 완료할 수 있습니다. 이 도구가 생성한 코드는 nlohmann/json과 함께 사용할 수 있으며, NLOHMANN_DEFINE_TYPE_INTRUSIVE, NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE 등의 매크로를 사용하여 자동 역직렬화를 구현할 수 있습니다. 단일 헤더 의존성, 풍부한 문서, STL 스타일과 일치하는 API로 대부분의 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 등 10여 가지 언어를 지원합니다. 이 도구는 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 영역에 배치해야 합니다(매크로가 private 필드에 접근하려면). 비침습적 버전인 NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE는 클래스 외부에 배치하여 클래스 자체를 수정할 필요가 없습니다. 이 도구가 생성한 struct에는 이러한 매크로가 자동으로 추가되지 않으므로, 필요할 때 수동으로 추가하여 JSON 키와 C++ 멤버의 대응 관계를 선언해야 합니다. JSON 필드명과 C++ 멤버명이 동일한 경우 이 매크로를 생략하고 j.get<T>()를 직접 사용할 수 있습니다.

JSON 타입에서 C++ 타입으로의 매핑 퀵 레퍼런스

도구는 JSON 값의 타입에 따라 해당 C++ 타입을 자동으로 추론합니다:

주요 C++ JSON 파서 선택 비교표

C++ 생태계의 주류 JSON 파싱 라이브러리 비교, 프로젝트 요구에 따라 선택:

일반적인 C++ 표준 라이브러리 타입과 JSON 대응 퀵 레퍼런스

C++ 표준 라이브러리에서 JSON 필드에 대응하는 핵심 타입 목록으로 개발자가 빠르게 참조할 수 있습니다:

Privacy & Security

이 JSON to C++ 도구의 모든 작업은 귀하의 브라우저에서 완전히 로컬로 완료됩니다: JSON 파싱, C++ 구조체 생성, 파일 다운로드는 모두 브라우저 JavaScript(Web Worker + quicktype-core)를 통해 클라이언트 측에서 실행되며, 네트워크를 통해 어떤 서버에도 JSON 내용, 업로드된 파일, 또는 생성된 코드를 보내지 않습니다. 파일 업로드는 브라우저의 네이티브 FileReader API를 사용하여 메모리로 직접 읽어들이며 중간 서비스를 거치지 않습니다. Cookie 추적을 사용하지 않으며, 사용자 입력이나 사용 데이터를 수집하지 않습니다. 페이지를 닫거나 새로고침한 후 모든 입력과 출력 내용은 메모리에서 자동으로 삭제됩니다. API 키, 토큰, 민감한 비즈니스 데이터가 포함된 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