JSON 데이터를 읽기 쉬운 형식으로 정리하는 방법

JSON 형식 정리란 무엇인가요?

JSON을 사람이 읽고 구조를 확인하기 쉬운 모양으로 바꾸려면 이 도구를 사용할 수 있습니다. 입력한 JSON을 계층이 드러나는 들여쓰기 텍스트로 형식화하므로, 한 줄로 이어진 데이터의 객체와 배열 관계를 살펴볼 때 유용합니다. 들여쓰기 설정을 조정할 수 있고, 필요할 때 객체 키 정렬도 선택할 수 있습니다.

이 기능은 JSON의 내용을 새로 작성하는 작업이 아니라, 유효한 JSON 데이터를 보기 좋은 텍스트 형태로 표시하는 작업입니다. 따라서 데이터의 값을 분석하거나 의미를 판정하는 용도로 이해하기보다, 구조를 확인하고 읽기 쉽게 정리하는 용도로 사용하는 편이 맞습니다. 입력에 한글과 같은 비ASCII 문자가 들어 있어도 결과에서는 해당 문자가 이스케이프되지 않은 상태로 보존됩니다.

검색어는 ‘JSON 데이터를 보기 좋게 정렬하고 들여쓰는 방법’으로 제안할 수 있습니다. 이는 한국어 사용자가 JSON 표시 형식을 정리하는 방법을 찾을 때 사용할 수 있는 검색 의도에 대한 가설이며, 실제 검색 수요를 뜻하지는 않습니다.

JSON 들여쓰기를 지정하는 순서

형식화할 JSON 텍스트를 입력란에 붙여 넣거나 직접 입력합니다. 입력은 선택 사항이지만, 실제 내용을 확인하려면 공백만 있는 입력이 아닌 JSON 텍스트를 제공해야 합니다. 입력란이 비어 있거나 공백만 있으면 성공으로 처리되더라도 형식화된 내용은 생성되지 않고 입력 없음 진단이 반환됩니다.
들여쓰기 설정을 확인합니다. 별도로 변경하지 않으면 기본값은 2칸입니다. 중첩된 객체나 배열의 계층을 더 넓은 간격으로 표시하고 싶다면 형식 지정 전에 원하는 들여쓰기 수준을 선택합니다. 이 설정은 결과에서 계층 사이를 구분하는 표시 간격에 영향을 줍니다.
객체 키의 배치를 일정한 순서로 보고 싶을 때만 키 정렬 옵션을 켭니다. 옵션이 활성화되면 객체의 키가 정렬된 순서로 배치됩니다. 입력에서 보이는 키의 순서를 정렬 대상으로 삼고 싶지 않다면 기본 상태인 꺼짐으로 둡니다. 키 정렬은 선택 사항이며, 들여쓰기 설정과 별개로 결정합니다.
형식 지정 동작을 실행합니다. 입력이 유효한 JSON이면 데이터가 파싱된 뒤 설정에 맞는 들여쓰기 텍스트로 반환되고 작업은 성공으로 표시됩니다. 성공 결과가 나타나면 계층, 배열 항목, 객체의 키와 값이 읽을 수 있는 간격으로 배치되었는지 확인합니다.
작업이 실패로 표시되면 입력을 다시 확인합니다. JSON 문법에 맞지 않는 텍스트는 형식화되지 않으므로, 문법 오류가 의심되는 부분을 수정한 뒤 다시 실행해야 합니다. 이때 입력을 일부만 남기기보다 형식화하려는 JSON 전체를 다시 확인하는 것이 좋습니다. 키 정렬을 켠 상태였다면 결과의 키 배치가 달라질 수 있으므로, 원래 입력의 배치와 비교할 때는 그 설정도 함께 확인합니다.
결과를 해석하기 전에 입력 상태와 설정을 함께 기록해 둡니다. 내용이 없는 결과는 실패와 같은 의미가 아닐 수 있습니다. 입력란이 실제로 비어 있었는지, 공백만 들어 있었는지, 유효한 JSON이었는지에 따라 결과의 의미가 달라집니다. 같은 데이터를 다시 표시할 때는 들여쓰기 수준과 키 정렬 상태를 동일하게 맞추면 결과 차이를 확인하기 쉽습니다.

결과를 해석하는 방법

성공으로 표시되고 형식화된 텍스트가 반환되면 입력 JSON이 들여쓰기 형식으로 처리된 것입니다. 중첩된 객체와 배열은 계층에 따라 구분되어 보이며, 선택한 들여쓰기 수준에 따라 각 계층의 간격이 달라집니다. 기본 설정을 그대로 사용했다면 들여쓰기는 2칸 기준으로 표시됩니다. 결과의 가독성이 목적이면 이 설정을 유지할 수 있고, 특정 표시 규칙에 맞춰야 하면 실행 전에 다른 수준을 선택할 수 있습니다.

키 정렬을 켠 경우에는 객체 키가 정렬된 순서로 배치됩니다. 따라서 키가 입력 당시 보이던 순서와 다르게 나타나도, 형식화 자체가 실패했다는 뜻은 아닙니다. 반대로 키 정렬을 켜지 않았다면 이 선택적 정렬은 적용되지 않습니다. 키의 배치가 중요한 자료를 비교할 때는 결과를 판단하기 전에 정렬 옵션의 상태를 확인해야 합니다.

입력란이 비어 있거나 공백만 있으면 성공이라는 표시가 있어도 형식화된 내용이 나오지 않고 입력 없음 진단이 반환됩니다. 이 경우에는 성공 표시만 보고 데이터가 처리되었다고 해석하지 말고, 먼저 입력이 전달되었는지 확인해야 합니다. 유효하지 않은 JSON은 형식화되지 않고 작업이 실패로 표시되므로, 빈 결과와 실패 결과를 구분해서 살펴보는 것이 중요합니다.

이 도구의 범위는 유효한 JSON을 읽기 쉬운 형식으로 표시하는 데 있습니다. 문법에 맞지 않는 JSON을 자동으로 복구하는 기능으로 이해해서는 안 됩니다. 문법 오류가 있는 자료를 처리하려면 먼저 입력을 유효한 JSON으로 정리한 다음 다시 형식화를 시도해야 합니다. 한글 등 비ASCII 문자는 결과에서 이스케이프되지 않고 보존되므로, 표시된 문자 자체가 바뀌었는지도 확인할 수 있습니다.

사용 예시

상품 정보 JSON의 구조를 확인하기 위해 한글 상품명과 수량을 입력하고 키 정렬 및 4칸 들여쓰기를 적용합니다.

두 개의 키와 한글 값을 포함한 유효한 JSON을 입력하고 들여쓰기 설정을 4칸으로 바꾼 뒤 키 정렬을 켜서 형식 지정 동작을 실행합니다.

작업 성공으로 표시되고, 입력한 객체가 들여쓰기된 텍스트로 반환됩니다. 키 정렬을 켰다면 객체 키가 정렬된 순서로 나타나며 한글 값은 이스케이프되지 않고 그대로 보존됩니다.

제한 사항

유효하지 않은 JSON은 형식화되지 않고 실패로 표시됩니다. 빈 입력이나 공백만 있는 입력은 형식화된 내용 없이 입력 없음 진단을 반환합니다.

자주 발생하는 오류

JSON이 아닌 문법의 텍스트를 입력하면 작업이 실패로 표시됩니다. 문법 오류가 의심되는 경우 중괄호와 대괄호의 짝, 문자열의 큰따옴표, 항목 사이의 쉼표를 확인해 유효한 JSON으로 수정한 뒤 다시 실행하세요.

자주 묻는 질문

기본 들여쓰기는 몇 칸인가요?

설정을 따로 바꾸지 않았다면 들여쓰기는 2칸입니다. 중첩 구조를 다른 간격으로 표시하려면 형식 지정 전에 들여쓰기 설정을 변경하세요.

객체의 키 순서도 바꿀 수 있나요?

키 정렬 옵션을 켜면 객체 키가 정렬된 순서로 배치됩니다. 옵션을 끄면 선택적 키 정렬이 적용되지 않으므로, 입력의 키 배치와 다른 순서가 필요할 때만 이 설정을 사용하세요.

입력란을 비워 두면 어떻게 되나요?

입력이 비어 있거나 공백만 있으면 성공으로 처리되지만 형식화된 내용은 생성되지 않고 입력 없음 진단이 반환됩니다. 형식화된 결과가 필요하면 JSON 텍스트를 입력한 뒤 다시 실행하세요.