JSON 포맷터 사용법과 자주 나는 오류

API 응답이나 설정 파일에서 가장 흔히 만나는 데이터 형식이 JSON입니다. 규칙은 단순하지만 작은따옴표 하나, 쉼표 하나 때문에 전체가 깨지기도 합니다. JSON의 핵심 규칙과 자주 나는 오류를 정리하고, JSON 포맷터로 바로 검증·정렬하는 방법을 알아봅니다.

한눈에 보기

• 키는 반드시 큰따옴표(") 로 감쌉니다. 작은따옴표·홑따옴표는 불가합니다.
• 마지막 요소 뒤 쉼표(trailing comma)는 금지입니다.
• JSON에는 주석을 쓸 수 없습니다.
• 정렬(pretty-print) 은 가독성을, 압축(minify) 은 용량 절감을 위한 것입니다.
• 오류가 의심되면 JSON 포맷터에 붙여 넣어 검증하세요. XML은 XML 포맷터를 이용하세요.

JSON 기본 규칙

JSON(JavaScript Object Notation)은 사람이 읽기 쉽고 기계가 처리하기 좋은 데이터 형식입니다. 지켜야 할 규칙은 명확합니다.

• 키(key)는 반드시 큰따옴표(") 로 감쌉니다.
• 문자열 값도 큰따옴표를 씁니다. 작은따옴표(')는 허용되지 않습니다.
• 객체나 배열의 마지막 요소 뒤에 쉼표를 붙이면 안 됩니다.
• 주석(// 또는 / /)을 넣을 수 없습니다.

올바른 예시는 다음과 같습니다.

{
  "name": "포켓인포",
  "year": 2026,
  "tags": ["tool", "guide"]
}

정렬(pretty-print)과 압축(minify)

같은 데이터라도 보기 좋게 펼치거나 용량을 줄이도록 정리할 수 있습니다.

개발 중 데이터를 확인할 때는 정렬을, 실제 전송이나 저장 시에는 압축을 활용하면 좋습니다. JSON 포맷터에서 한 번에 전환할 수 있습니다.

흔한 오류와 해결법

이 네 가지가 가장 자주 발생하는 오류입니다. 특히 작은따옴표와 트레일링 콤마는 JavaScript 객체 문법과 헷갈려 생기는 경우가 많습니다. JSON은 더 엄격하다는 점을 기억하세요.

자주 묻는 질문

JSON에서 작은따옴표를 써도 되나요?

안 됩니다. 키와 문자열 값 모두 큰따옴표(")만 허용됩니다. 작은따옴표나 홑따옴표를 쓰면 오류가 납니다.

마지막 항목 뒤에 쉼표를 붙여도 되나요?

안 됩니다. 트레일링 콤마는 JSON에서 금지됩니다. 마지막 요소 뒤의 쉼표는 반드시 삭제해야 합니다.

JSON에 주석을 달 수 있나요?

표준 JSON은 주석을 지원하지 않습니다. 설명이 필요하면 별도 키에 값으로 담거나, 주석을 허용하는 다른 형식을 고려하세요.

정렬과 압축 중 무엇을 써야 하나요?

사람이 읽고 디버깅할 때는 정렬(pretty-print), 전송·저장으로 용량을 줄일 때는 압축(minify)을 사용합니다.

마무리

JSON은 규칙이 단순한 만큼 작은 실수에 민감합니다. 큰따옴표, 트레일링 콤마 금지, 주석 불가만 기억하면 대부분의 오류를 피할 수 있습니다. 작성한 JSON이 의심되면 JSON 포맷터로 검증하고, XML 데이터는 XML 포맷터로 정리해 보세요.