JSON 포맷팅 및 유효성 검사 방법 — 무료 온라인 가이드

API 응답을 디버깅하든 설정 파일을 편집하든, 가독성 좋은 JSON은 작업 시간을 크게 줄여 줍니다. 이 가이드에서는 JSON 포맷팅, 유효성 검사, 구조 확인 방법을 브라우저에서 바로 처리하는 방법으로 설명합니다.

JSON 포맷팅(들여쓰기 정렬)

1. JSON 포매터를 엽니다.
2. JSON을 붙여 넣습니다.
3. 들여쓰기를 2칸 또는 4칸으로 선택하고 Format 버튼을 클릭합니다.
4. 정리된 결과를 복사하거나 다운로드합니다.

JSON 유효성 검사 및 오류 찾기

잘못된 JSON은 대부분 끝에 붙은 쉼표, 작은따옴표 사용, 또는 괄호 누락 때문에 발생합니다. JSON 검증 도구에 데이터를 붙여 넣으면 유효 여부와 정확한 오류 위치를 바로 확인할 수 있습니다.

자주 나타나는 수정 사항:

• 키와 문자열 값에는 반드시 큰따옴표를 사용하세요. 작은따옴표는 허용되지 않습니다.
• 마지막 항목 뒤의 불필요한 쉼표를 제거하세요.
• 문자열 내부의 특수 문자는 이스케이프 처리하세요.

대용량 JSON 살펴보기

데이터가 많을 때는 스크롤보다 트리 보기가 훨씬 편리합니다. JSON 뷰어는 JSON을 접고 펼칠 수 있는 트리 구조로 렌더링하여 필요한 부분만 확인할 수 있습니다.

프로덕션 배포 전 용량 줄이기

배포 전에 JSON 미니파이어로 공백을 제거하면 페이로드 크기를 줄일 수 있습니다.

자주 묻는 질문

JSON이 업로드되나요? 아니요. 모든 처리는 브라우저 안에서 이루어집니다.

JSON이 유효하지 않은 이유는 무엇인가요? 엄격한 JSON 규격은 주석, 끝에 붙은 쉼표, 작은따옴표를 허용하지 않습니다. 검증 도구가 이러한 문제를 자동으로 표시해 줍니다.

문제 해결

• 맨 앞에서 "Unexpected token" 오류가 납니다. 감싸인 응답을 붙여 넣었을 가능성이 큽니다 — callback({...}) 같은 JSONP 콜백이거나 오류 페이지의 HTML 같은 것입니다. 첫 { 또는 [ 앞의 내용을 모두 제거하세요.
• 유효해 보이는 설정을 포매터가 거부합니다. JSON5나 .jsonc 같은 편집기용 형식은 주석과 끝에 붙은 쉼표를 허용하지만, 엄격한 JSON은 그렇지 않습니다. // 주석과 마지막 괄호 앞의 불필요한 쉼표를 제거하세요.
• 둥근 따옴표가 파싱을 깨뜨립니다. Word나 Slack에서 복사한 텍스트에는 곧은 " 대신 "스마트 따옴표"(" ")가 들어 있는 경우가 많습니다. 이를 일반 큰따옴표로 찾아 바꾼 뒤 JSON 포매터를 다시 실행하세요.