API 응답이나 설정 파일을 다루다 보면 한 줄로 뭉쳐 있는 JSON을 사람이 읽을 수 있게 펼쳐 보거나, 반대로 용량을 줄이기 위해 공백을 모두 제거해 압축해야 할 때가 많습니다. JSON 포맷터·검증 도구는 들여쓰기 정렬, 압축(minify), 그리고 어디에서 문법이 깨졌는지 알려 주는 유효성 검사를 한곳에서 처리합니다.
정렬(pretty)은 표준 JSON.parse로 구조를 읽은 뒤 지정한 칸 수로 다시 출력하므로, 들여쓰기가 엉망인 응답도 일관된 모양으로 정리됩니다. 압축(minify)은 모든 공백과 줄바꿈을 제거해 가장 짧은 형태로 만들고, 키 정렬 옵션을 켜면 모든 객체의 키를 재귀적으로 사전순 정렬해 두 JSON을 비교하기 쉽게 만듭니다. 정렬은 값이나 데이터를 바꾸지 않고 보기 좋게만 다듬습니다.
이 도구는 입력한 JSON을 서버로 보내지 않고 브라우저의 자바스크립트 엔진에서 직접 파싱합니다. 사내 API 응답이나 인증 토큰이 포함된 설정처럼 외부로 내보내기 곤란한 데이터도 안심하고 붙여 넣어 정리할 수 있습니다. 결과는 모노스페이스 글꼴로 표시되며 복사 버튼으로 한 번에 가져갈 수 있습니다.
사용 방법
- 1
JSON 붙여넣기
정리하거나 검사할 JSON 문자열을 입력란에 붙여 넣습니다. 객체, 배열, 중첩 구조 모두 지원합니다.
- 2
옵션 선택
들여쓰기를 2칸 또는 4칸으로 고르고, 필요하면 '키 정렬'을 체크해 객체 키를 사전순으로 정렬합니다.
- 3
동작 실행
'정렬'로 보기 좋게 펼치거나 '압축'으로 한 줄로 만들 수 있고, '유효성 검사'로 문법 오류 여부만 빠르게 확인할 수 있습니다.
- 4
결과 복사
결과 영역의 복사 버튼을 눌러 클립보드로 가져갑니다. 문법 오류가 있으면 어떤 위치에서 문제가 났는지 메시지로 표시됩니다.
이럴 때 유용해요
압축된 API 응답 읽기
한 줄로 뭉쳐 온 응답을 정렬해 중첩 구조와 필드 값을 한눈에 파악합니다.
JSON 문법 오류 잡기
설정 파일이 로드되지 않을 때 붙여 넣어 유효성 검사로 누락된 따옴표나 trailing comma 위치를 찾습니다.
두 JSON 비교 전 정규화
키 정렬과 동일한 들여쓰기로 두 객체를 맞춰, diff에서 순서 차이로 생기는 잡음을 없앱니다.
한 줄 설정 값 만들기
환경 변수나 단일 라인 설정에 넣기 위해 JSON을 압축해 공백 없는 형태로 변환합니다.
활용 팁
- 키 정렬 옵션은 두 JSON을 비교(diff)하기 전에 키 순서를 통일해 불필요한 차이를 없애는 데 유용합니다.
- 압축한 JSON은 환경 변수나 한 줄짜리 설정 값으로 넣을 때 편리합니다.
- 유효성 검사 메시지의 위치 정보(예: position)는 오류가 난 문자 인덱스를 가리킵니다. 따옴표 누락이나 마지막 쉼표(trailing comma)를 먼저 의심하세요.
- 여러 줄 주석이 포함된 JSON5나 JSONC는 표준 JSON이 아니므로 파싱에 실패합니다. 주석을 지운 뒤 사용하세요.
- 키에는 반드시 큰따옴표가 필요합니다. 작은따옴표나 따옴표 없는 키는 자바스크립트 객체 리터럴일 뿐 유효한 JSON이 아닙니다.
- 정렬·압축은 JSON.parse로 읽었다 다시 출력하므로, 의미 없는 공백뿐 아니라 숫자 표기(예: 1.0 → 1)도 정규화될 수 있습니다.
자주 묻는 질문
입력한 JSON이 서버로 전송되나요?
아니요. 파싱과 정렬, 압축, 검사 모두 사용자의 브라우저에서만 이루어지며 데이터가 외부로 전송되지 않습니다.
왜 유효성 검사에서 오류가 나나요?
키와 문자열에 큰따옴표가 빠졌거나, 마지막 항목 뒤에 쉼표가 남아 있거나, 작은따옴표를 사용한 경우 표준 JSON 문법 위반으로 오류가 납니다. 표시된 위치를 참고해 수정하세요.
키 정렬은 어떻게 동작하나요?
모든 객체의 키를 재귀적으로 사전순(유니코드 코드포인트 순)으로 정렬합니다. 배열의 순서는 그대로 유지됩니다.
아주 큰 JSON도 처리되나요?
수 MB 규모의 JSON도 대부분 즉시 처리됩니다. 다만 매우 큰 파일은 브라우저 메모리에 따라 속도가 달라질 수 있습니다.
한글이나 이모지가 깨지나요?
아니요. 자바스크립트의 표준 JSON 처리를 사용하므로 한글, 이모지 등 유니코드 문자가 그대로 보존됩니다.
JSON5나 주석이 있는 JSONC도 되나요?
아니요. 이 도구는 표준 JSON만 처리합니다. //나 /* */ 주석, 따옴표 없는 키, trailing comma가 있으면 파싱이 실패하므로 표준 형식으로 정리한 뒤 사용하세요.
정렬해도 데이터가 바뀌지 않나요?
값과 구조는 그대로 유지되고 들여쓰기만 바뀝니다. 다만 숫자 표기 정규화(1.0이 1로 표시되는 등)나 키 순서 변경(키 정렬 시)은 일어날 수 있습니다.
검사에서 'Unexpected token' 같은 메시지가 나옵니다.
예상치 못한 문자에서 파싱이 멈췄다는 뜻입니다. 대개 닫히지 않은 괄호·따옴표, 잘못된 쉼표가 원인이니 메시지가 가리키는 위치 주변을 확인하세요.