JSON 포맷 가이드 — JSON 구조, 문법, 포맷팅·검증 방법
작성
API 응답, 설정 파일, 데이터 교환 등 어디서나 쓰이는 JSON. 기본 문법부터 자주 하는 실수, 포맷팅 방법까지 정리합니다.
JSON 기본 구조
JSON은 키-값 쌍으로 이루어진 데이터 형식입니다. 키는 반드시 큰따옴표(")로 감싸야 합니다.
JSON 데이터 타입
| 타입 | 예시 | 설명 |
|---|---|---|
| 문자열 | "hello" | 큰따옴표로 감싼 텍스트 |
| 숫자 | 42, 3.14 | 정수 또는 소수 |
| 불리언 | true, false | 참/거짓 |
| null | null | 값 없음 |
| 배열 | [1, 2, 3] | 순서가 있는 값 목록 |
| 객체 | {"key": "value"} | 키-값 쌍의 집합 |
자주 하는 JSON 문법 오류
- 후행 쉼표: 마지막 항목 뒤에 쉼표를 넣으면 오류
- 작은따옴표: JSON은 큰따옴표만 허용
- 키에 따옴표 누락: 모든 키를 "로 감싸야 함
- 주석 사용: 표준 JSON은 주석 미지원
JSON 정리기로 바로 확인하기
JSON을 붙여넣으면 보기 좋게 포맷팅하거나, 한 줄로 압축하거나, 유효성을 검사할 수 있습니다.
자주 묻는 질문
JSON과 JavaScript 객체의 차이는?
JSON은 키를 반드시 큰따옴표로 감싸야 하고, 함수나 undefined를 값으로 사용할 수 없습니다. 또한 후행 쉼표(trailing comma)를 허용하지 않습니다.
JSON에서 주석을 쓸 수 있나요?
표준 JSON은 주석을 지원하지 않습니다. 주석이 필요하면 JSONC(JSON with Comments)나 JSON5 같은 확장 형식을 사용할 수 있습니다.
JSON이 유효하지 않다는 오류가 나는 이유는?
대부분 후행 쉼표, 작은따옴표 사용, 키에 따옴표 누락, 또는 제어 문자 포함이 원인입니다. JSON 검증 도구로 정확한 위치를 확인할 수 있습니다.