JSON 텍스트 형식 정리 및 유효성 확인 방법

JSON Formatter로 할 수 있는 작업

JSON Formatter는 JSON 텍스트를 읽고 파싱할 수 있는지 확인한 다음, 설정에 맞춰 읽기 쉬운 JSON 텍스트로 정리하는 도구입니다. 개발 중인 응답 데이터의 구조를 살펴보거나, 여러 사람이 확인할 JSON의 표현을 맞출 때 사용할 수 있습니다. 입력한 내용이 JSON 문법에 맞으면 형식이 정리된 결과를 얻을 수 있고, 문법을 해석하지 못하면 실패 결과와 파싱 오류 세부 정보가 반환됩니다.

이 도구에서는 결과의 모양을 몇 가지 방식으로 조정할 수 있습니다. 들여쓰기 값을 지정하면 중첩된 객체나 배열을 구분하기 쉬운 형태로 표시할 수 있습니다. 기본 들여쓰기 값은 2입니다. 객체 키 정렬을 선택하면 출력되는 객체의 키 순서가 정렬된 형태로 바뀔 수 있습니다. 압축 출력을 선택하면 들여쓰기 대신 쉼표와 콜론 사이의 공백이 없는 간결한 직렬화 형식으로 결과가 만들어집니다. 따라서 사람이 읽을 결과와 간결한 전달용 결과 가운데 목적에 맞는 방식을 고를 수 있습니다.

JSON 형식 정리 및 확인 절차

확인하려는 JSON 텍스트를 입력 영역에 붙여 넣습니다. 입력은 선택 사항이므로 내용을 넣지 않고 실행할 수도 있지만, 빈 입력은 검사할 JSON이 제공되지 않은 상태로 처리됩니다. 실제 문법 확인과 형식 정리를 하려면 JSON 텍스트를 입력하세요.
들여쓰기 값을 정합니다. 별도의 값을 선택하지 않으면 기본값인 2가 적용됩니다. 중첩 구조를 더 넓게 띄우거나 더 좁게 표시하고 싶을 때 목적에 맞는 값을 선택합니다. 이 설정은 파싱 가능한 JSON이 결과로 직렬화될 때 표시 형식에 반영됩니다.
객체 키의 순서를 정리해야 할 때 키 정렬 옵션을 켭니다. 이 옵션은 기본적으로 꺼져 있으며, 켜면 형식이 정리된 결과에서 객체 키가 정렬된 순서로 출력됩니다. 원래 입력의 키 순서를 그대로 비교해야 한다면 이 옵션을 켜기 전에 목적을 확인하세요.
간결한 표현이 필요할 때 압축 출력을 켭니다. 압축 출력이 활성화되면 들여쓰기와 같은 보기용 형식 대신 쉼표와 콜론 사이의 공백이 없는 형태로 직렬화됩니다. 사람이 구조를 검토하는 단계에서는 일반 형식을 사용하고, 간결한 결과가 필요한 단계에서는 압축 출력을 선택하는 식으로 구분할 수 있습니다.
결과의 상태와 내용을 함께 확인합니다. 유효한 JSON이면 설정에 맞춰 형식이 정리된 텍스트가 생성됩니다. JSON을 파싱할 수 없으면 작업은 실패로 보고되며 파싱 오류 세부 정보가 포함되고, 제출한 텍스트도 반환 내용으로 유지됩니다. 오류 내용을 참고해 원문의 문법을 수정한 뒤 수정한 JSON을 다시 입력합니다.

결과 해석과 사용 범위

성공 결과는 입력한 텍스트가 JSON으로 파싱되었고, 선택한 설정에 따라 결과 텍스트가 생성되었다는 의미입니다. 성공했다는 사실만으로 특정 데이터 구조가 업무 규칙에 맞는지, 필요한 필드가 들어 있는지까지 확인되었다고 해석해서는 안 됩니다. 이 도구가 제공하는 확인은 JSON 텍스트를 파싱할 수 있는지와 그 결과를 형식에 맞춰 정리하는 범위입니다.

키 정렬을 켰다면 입력할 때의 객체 키 순서와 결과의 순서가 달라질 수 있습니다. 따라서 원문과 결과를 글자 단위로 비교할 때는 이 옵션의 사용 여부를 함께 기록하는 편이 좋습니다. 압축 출력을 켰다면 줄바꿈과 들여쓰기 중심의 표시가 아니라 쉼표와 콜론 사이의 공백이 없는 형식이 됩니다. 이는 형식 선택의 차이이며, 파싱 성공 여부와 별개의 표시 설정입니다.

한글을 비롯한 유니코드 문자는 유효한 JSON 안에서 형식이 정리된 텍스트에 유지될 수 있습니다. 반대로 파싱 실패 결과는 단순히 보기 좋지 않은 출력이 아니라 JSON 문법을 해석하지 못했다는 신호입니다. 오류 세부 정보를 기준으로 문자열 따옴표, 쉼표, 중괄호와 대괄호의 짝을 차례로 살펴보세요. 입력이 공백뿐이거나 비어 있으면 실패로 보지 않고 JSON 입력이 제공되지 않은 상태로 처리되며, 형식이 정리된 콘텐츠는 생성되지 않습니다.

사용 예시

개발자가 이름과 나이 정보가 담긴 {"name":"민지","age":20}을 보기 쉽게 정리하려고 JSON Formatter에 입력합니다.

이름과 나이 정보가 담긴 JSON이 파싱되는지 확인한 뒤 들여쓰기를 2로 두고 키 정렬을 켜서 결과를 확인합니다.

성공 결과에는 기본값인 2칸 들여쓰기가 적용된 JSON 텍스트가 생성되고, 키 정렬을 켰으므로 객체 키는 정렬된 순서로 나타납니다.

제한 사항

확인 범위는 JSON 텍스트의 파싱 가능 여부와 형식 정리입니다. 스키마 규칙, JSON 경로 조건, 업무상 필수 항목까지 확인하는 기능으로 보아서는 안 됩니다.

자주 발생하는 오류

쉼표나 문자열을 감싸는 따옴표가 빠진 텍스트를 입력하면 파싱에 실패할 수 있습니다. 오류 세부 정보가 가리키는 부분을 확인하고 JSON 문법을 수정한 뒤 수정한 원문을 다시 제출하세요.

자주 묻는 질문

JSON 입력 없이도 사용할 수 있나요?

입력하지 않은 경우에는 JSON 입력이 제공되지 않은 상태로 성공 처리되지만, 형식이 정리된 콘텐츠는 생성되지 않습니다. 파싱과 형식 정리를 하려면 JSON 텍스트를 입력해야 합니다.

객체의 키 순서를 정렬할 수 있나요?

객체 키 정렬 옵션을 켜면 형식이 정리된 결과에서 객체 키가 정렬된 순서로 출력될 수 있습니다. 이 옵션은 기본적으로 꺼져 있습니다.

JSON을 간결한 형식으로 출력할 수 있나요?

압축 출력을 켜면 들여쓰기 대신 쉼표와 콜론 사이의 공백이 없는 간결한 직렬화 형식으로 결과가 만들어집니다.