JSON은 문법이 단순하지만, 따옴표 하나나 쉼표 하나만 잘못 찍어도 전체가 깨집니다. 기본 규칙과 자주 나는 오류만 알아두면 대부분 금방 고칠 수 있습니다.
JSON이란
JSON(JavaScript Object Notation)은 데이터를 키(key)와 값(value)의 쌍으로 표현하는 텍스트 형식입니다. 웹사이트와 앱이 서버와 데이터를 주고받을 때, 설정 파일을 저장할 때 널리 씁니다. 사람이 읽기 쉬우면서도 프로그램이 그대로 해석할 수 있는 게 장점입니다.
기본 문법 규칙
JSON에서 값으로 쓸 수 있는 건 다음 6가지뿐입니다.
{"이름":"뚝딱","나이":5,"활성":true,"주소":null,"도구":["json","qr"],"설정":{"다크모드":false}}
- 문자열 — 반드시 큰따옴표(
")로 감쌉니다."뚝딱" - 숫자 — 따옴표 없이 그대로.
5,3.14 - 불리언 —
true또는false(소문자, 따옴표 없음) - null — 값이 없음을 뜻하는 전용 키워드(따옴표 없음)
- 배열 — 대괄호
[ ]로 감싼 값의 목록 - 객체 — 중괄호
{ }로 감싼 키-값 쌍의 모음
키(key)는 항상 큰따옴표로 감싼 문자열이어야 합니다. 자바스크립트 코드에서는 따옴표 없는 키({name: "뚝딱"})도 되지만, JSON에서는 안 됩니다.
자주 나는 오류 4가지
1. 마지막 항목 뒤에 쉼표(trailing comma)
{"a":1,"b":2,}처럼 마지막 값 뒤에 쉼표가 남아있으면 오류가 납니다. 자바스크립트는 봐주지만 JSON은 엄격합니다. 마지막 항목 뒤 쉼표는 반드시 지우세요.
2. 키에 따옴표 빠뜨림
{name:"뚝딱"}처럼 키를 따옴표 없이 쓰면 오류입니다. {"name":"뚝딱"}처럼 키도 큰따옴표로 감싸야 합니다.
3. 작은따옴표 사용
{'name':'뚝딱'}처럼 작은따옴표(')를 쓰면 오류입니다. JSON은 오직 큰따옴표(")만 인정합니다.
4. 문자열 안 줄바꿈·제어문자
문자열 값 안에 실제 줄바꿈이 그대로 들어가면 오류입니다. 줄을 바꾸고 싶다면 \n처럼 이스케이프 문자를 써야 합니다. 큰따옴표 자체를 문자열 안에 넣고 싶을 때도 \"처럼 백슬래시로 이스케이프합니다.
정렬(들여쓰기)과 압축(한 줄)은 언제 쓰나요
여러 줄로 정렬하면 구조가 한눈에 보여 읽거나 디버깅하기 좋습니다. 반대로 압축해 한 줄로 만들면 파일 용량이 줄어 API 응답이나 저장용 데이터로 적합합니다. 어느 쪽이든 담긴 데이터 자체는 똑같습니다.
바로 확인해 보기
JSON 포맷터에 JSON을 붙여넣으면 문법 오류가 있는 위치를 바로 알려주고, 정렬·압축도 한 번에 됩니다. 모든 처리는 브라우저 안에서만 이뤄지고 입력 내용은 서버로 전송되지 않습니다.