JSON 포맷터·검증기

JSON이 깨졌다고 나올 때 가장 흔한 원인 5가지

JSON 문법 오류의 대부분은 몇 가지 정해진 실수에서 나옵니다. 이 도구는 오류 위치를 몇 번째 줄 몇 칸인지로 알려주므로, 아래 항목과 대조하면 대개 몇 초 안에 원인을 찾습니다.

• 마지막 항목 뒤에 쉼표가 남아 있음 — 자바스크립트 객체는 허용하지만 JSON은 오류입니다. 배열이나 객체의 닫는 괄호 바로 앞을 보세요.
• 작은따옴표 사용 — JSON의 문자열과 키는 반드시 큰따옴표여야 합니다.
• 키에 따옴표가 없음 — {name: "홍길동"} 은 JSON이 아닙니다. {"name": "홍길동"} 이어야 합니다.
• 주석이 들어감 — JSON 표준에는 주석이 없습니다. // 나 /* */ 가 있으면 오류입니다.
• 값이 undefined 이거나 NaN — JSON에는 이런 값이 없습니다. null 을 쓰거나 키를 빼야 합니다.

트리 보기로 깊은 구조 파악하기

API 응답처럼 중첩이 깊은 JSON은 정렬만 해서는 전체 구조가 눈에 안 들어옵니다. 결과 영역의 트리 탭으로 바꾸면 각 노드를 접었다 펼 수 있어, 관심 있는 가지만 열어 볼 수 있습니다.

배열 옆에는 항목 개수가, 객체 옆에는 키 개수가 표시됩니다. 응답에 데이터가 몇 건 담겼는지 일일이 세지 않아도 바로 확인됩니다.

1. 입력창에 JSON을 붙여넣고 "정렬"을 누릅니다.
2. 결과 영역 위의 "트리" 탭을 선택합니다.
3. 삼각형 표시를 눌러 원하는 가지만 펼칩니다.
4. 하단 통계에서 전체 크기·키 개수·최대 깊이·노드 수를 확인합니다.

정렬과 압축, 언제 무엇을 쓰나

정렬(Pretty)은 사람이 읽기 위한 것이고, 압축(Minify)은 기계에 보내기 위한 것입니다. 둘은 데이터가 완전히 같고 공백만 다릅니다.

키 정렬은 언제 유용한가

"키 정렬(A→Z)"을 켜면 객체의 키를 알파벳순으로 다시 정렬합니다. 두 JSON을 비교할 때 특히 유용합니다. 같은 데이터인데 키 순서만 달라서 비교 결과가 온통 빨갛게 뜨는 상황을, 양쪽 다 키 정렬해서 비교하면 진짜 차이만 남습니다.

큰 파일을 다룰 때

파일은 드래그해서 놓거나 드롭존을 클릭해 선택할 수 있습니다. 브라우저가 직접 읽기 때문에 업로드가 일어나지 않고, 그래서 사내 데이터나 운영 로그도 안심하고 열어볼 수 있습니다.

다만 브라우저에서 처리하는 만큼 한계는 있습니다. 수 MB 수준까지는 무리 없지만 수십 MB를 넘으면 트리 렌더링이 느려질 수 있습니다. 그럴 땐 트리 대신 텍스트 탭을 쓰거나 명령줄 도구를 쓰는 편이 낫습니다.

# 아주 큰 JSON은 명령줄이 빠릅니다
jq . big.json > pretty.json     # 정렬
jq -c . big.json > small.json   # 압축