1. 홈
  2. 개발자
  3. JSON 평탄화·복원

JSON 평탄화·복원

중첩 JSON을 점 표기 키로 펴고, 다시 원래 모양으로 되돌립니다.

내 브라우저에서 처리 · 업로드 없음
결과
{ "주문.번호": "A-1001", "주문.고객.이름": "김민지", "주문.고객.등급": "VIP", "주문.상품.0.이름": "티셔츠", "주문.상품.0.수량": 2, "주문.상품.1.이름": "볼캡", "주문.상품.1.수량": 1, "주문.태그.0": "신규", "주문.태그.1": "선물", "주문.메모": null }
값 개수
10

입력한 JSON 과 파일은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

사용 방법

  1. 위에서 평탄화 또는 복원을 고릅니다.
  2. JSON 을 붙여넣거나 .json·.jsonl·.ndjson 파일을 올립니다. 파일은 20MB 까지 읽습니다.
  3. 경로 구분자, 배열 경로 표기, 배열 처리, 펼칠 깊이를 고르면 결과가 바로 바뀝니다.
  4. 결과를 복사하거나 내려받습니다. 결과를 입력으로를 누르면 반대 방향으로 한 번 더 변환해 원래대로 돌아오는지 확인할 수 있습니다.

평탄화란

중첩된 JSON 의 모든 값을 주문.고객.이름 처럼 경로를 이은 키 하나로 바꿔, 한 단계짜리 객체로 만드는 것입니다. 아래 JSON 은

{"주문":{"번호":"A-1001","고객":{"이름":"김민지","등급":"VIP"},"상품":[{"이름":"티셔츠","수량":2},{"이름":"볼캡","수량":1}],"태그":["신규","선물"],"메모":null}}

기본 설정에서 이렇게 펴집니다.

{
  "주문.번호": "A-1001",
  "주문.고객.이름": "김민지",
  "주문.고객.등급": "VIP",
  "주문.상품.0.이름": "티셔츠",
  "주문.상품.0.수량": 2,
  "주문.상품.1.이름": "볼캡",
  "주문.상품.1.수량": 1,
  "주문.태그.0": "신규",
  "주문.태그.1": "선물",
  "주문.메모": null
}

옵션 설명

같은 입력으로 설정을 바꿨을 때의 결과입니다.

설정 결과
배열 경로: 대괄호 "주문.상품[0].이름": "티셔츠"
배열 처리: 값 배열은 그대로 "주문.태그": ["신규","선물"] (객체가 든 상품 배열은 계속 펼침)
출력 모양: 경로 = 값 목록 주문.고객.이름 = "김민지" 처럼 한 줄에 하나. 문자열은 따옴표로 감싸 숫자와 구분
펼칠 깊이: 2단계 "주문.고객": {"이름":"김민지","등급":"VIP"} 처럼 2단계 아래는 그대로 둠 (최상위 키가 1단계)
배열이면 항목마다 따로 최상위가 배열일 때 항목 하나하나를 평탄화한 객체의 배열로. 표의 행과 같은 모양
경로 구분자 점, 슬래시, 밑줄, 밑줄 두 개, 콜론

복원 규칙

  • a.0, a.1 처럼 0부터 빈틈없이 이어진 숫자 키는 배열이 됩니다. a.1, a.2 처럼 0이 빠지면 객체로 둡니다. “0부터 이어진 숫자 키는 배열로”를 끄면 항상 객체입니다.
  • 대괄호 표기 a[2] 는 항상 배열을 뜻하며, 비는 자리는 null 로 채웁니다. 번호가 100,000 을 넘는 키는 메모리를 지키려고 건너뜁니다.
  • 한 키가 값이면서 다른 키의 앞부분이기도 하면(a: 1 과 a.b: 2) 충돌입니다. 뒤에 나온 키를 건너뛰고 어느 키인지 알려 줍니다.
  • 입력이 평탄한 객체의 배열이면 항목마다 복원합니다.
  • __proto__ 같은 키가 있어도 객체의 기본 동작을 건드리지 않고 일반 키로 다룹니다.
  • 자바스크립트 객체 규칙상 "1", "2" 처럼 정수 모양의 키는 다른 키보다 앞에 오름차순으로 나옵니다.

점이 들어 있는 키

{"a.b": 1, "a": {"b": 2}} 는 경로로 쓰면 둘 다 a.b 가 되어 서로 덮어씁니다. 이 도구는 키 안의 구분자와 역슬래시 앞에 \ 를 붙여 구분합니다.

{"a\\.b": 1, "a.b": 2}

JSON 에서는 역슬래시가 \\ 로 두 번 보이지만 실제 첫 키는 a\.b 입니다. 복원할 때 이 \ 를 다시 읽으므로 원래 모양이 돌아옵니다. “키 안의 구분자는 \ 로 막기”를 끄면 결과는 {"a.b": 2} 가 되고, 앞의 값이 덮였다는 안내가 나옵니다.

알아 둘 점

  • 12345678901234567890, 10.50, 1e3 같은 숫자는 자바스크립트 숫자로 읽으면 값이 달라지지만, 이 도구는 원문 그대로 지킵니다.
  • 값이 500,000개를 넘으면 앞부분만 평탄화하고 알려 줍니다. 중첩은 200단계까지 읽습니다.
  • JSON 문법이 틀리면 줄과 칸, 원인을 알려 줍니다. 끝 쉼표, 작은따옴표, 따옴표 없는 키가 흔한 원인입니다.

자주 묻는 질문

JSON 평탄화는 어디에 쓰나요?

설정값을 db.host 같은 키로 다루는 환경 변수·properties 형식, 번역 파일의 키, 스프레드시트의 열, 로그에서 필드 하나만 검색하는 경우처럼 구조보다 경로로 접근하는 값이 필요할 때 씁니다.

.0 과 [0] 은 무엇이 다른가요?

둘 다 배열의 0번째를 가리킵니다. 점 표기(a.0.b)는 a 가 객체인지 배열인지 키만 봐서는 알 수 없어, 복원할 때 0부터 이어지는 숫자일 때만 배열로 추정합니다. 대괄호 표기(a[0].b)는 처음부터 배열이라고 밝히므로 더 정확합니다.

평탄화한 결과를 표로 보고 싶어요.

JSON 표로 보기는 행마다 평탄화해 열로 펼친 표를 보여 주고 CSV·Markdown 으로 내보냅니다.

복원했는데 일부 키가 사라졌어요.

충돌한 키는 건너뛰고, 화면 위쪽에 건너뛴 키를 알려 줍니다. 값과 객체가 같은 경로를 쓰고 있지 않은지 확인하세요.

관련 도구: JSON 포맷터, JSON CSV 변환, JSON ↔ YAML 변환, JSON 비교

입력한 JSON 과 파일은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.