💻 개발·기술

JSON 완벽 정리: 개발자가 알아야 할 모든 것

JSON의 기본 문법부터 실무 활용법, 흔한 실수와 디버깅 팁까지. 웹 개발자를 위한 JSON 완벽 가이드.

📅 2025년 11월 20일✍️ HMApps

JSON웹개발APIREST데이터포맷

JSON이란?

JSON(JavaScript Object Notation)은 데이터를 저장하고 교환하기 위한 경량 텍스트 형식입니다. 2001년 Douglas Crockford가 제안했으며, 현재 웹 개발에서 가장 널리 사용되는 데이터 포맷입니다.

이름에 JavaScript가 들어있지만, 사실상 모든 프로그래밍 언어에서 지원합니다. Python, Java, Go, Rust, PHP 등 어떤 언어를 쓰든 JSON을 다루게 됩니다.

왜 JSON이 표준이 되었나?

JSON 이전에는 XML이 데이터 교환의 표준이었습니다. 하지만 JSON이 빠르게 대체한 이유가 있습니다.

JSON vs XML 비교

같은 데이터를 표현할 때의 차이를 보면:

// JSON (간결함)
{
  "name": "홍길동",
  "age": 30,
  "skills": ["JavaScript", "Python"]
}

// XML (장황함)
<person>
  <name>홍길동</name>
  <age>30</age>
  <skills>
    <skill>JavaScript</skill>
    <skill>Python</skill>
  </skills>
</person>

JSON의 장점은 명확합니다:

가독성: 사람이 읽기 쉬움
경량: 같은 데이터를 더 적은 용량으로 표현
파싱 속도: XML보다 파싱이 빠름
JavaScript 호환: 웹 환경에서 네이티브 지원

JSON 기본 문법

JSON은 6가지 데이터 타입을 지원합니다.

1. 문자열 (String)

반드시 큰따옴표로 감싸야 합니다. 작은따옴표는 허용되지 않습니다.

{ "name": "홍길동" }     // ✅ 올바름
{ "name": '홍길동' }     // ❌ 작은따옴표 불가
{ name: "홍길동" }       // ❌ 키에도 큰따옴표 필수

2. 숫자 (Number)

정수와 소수 모두 가능하며, 따옴표 없이 사용합니다.

{ "age": 30, "height": 175.5, "score": -10 }

3. 불린 (Boolean)

소문자 true, false만 허용됩니다.

{ "active": true, "deleted": false }

4. null

값이 없음을 나타냅니다. undefined는 JSON에서 사용할 수 없습니다.

{ "middleName": null }

5. 배열 (Array)

대괄호로 감싸며, 서로 다른 타입을 혼합할 수 있습니다.

{ "tags": ["개발", "프론트엔드", 42, true, null] }

6. 객체 (Object)

중괄호로 감싸며, 중첩이 가능합니다.

{
  "user": {
    "name": "홍길동",
    "address": {
      "city": "서울",
      "zip": "06000"
    }
  }
}

실무에서 자주 하는 실수 TOP 5

1. 마지막 쉼표 (Trailing Comma)

JavaScript에서는 허용되지만, JSON에서는 문법 오류입니다.

// ❌ 마지막 쉼표
{ "a": 1, "b": 2, }

// ✅ 올바름
{ "a": 1, "b": 2 }

2. 주석 사용

JSON은 주석을 지원하지 않습니다. 설정 파일에서 주석이 필요하다면 JSONC나 YAML을 고려하세요.

// ❌ 주석 불가
{
  // 사용자 이름
  "name": "홍길동"
}

// ✅ 대안: 별도 필드로 설명
{
  "_comment": "사용자 정보",
  "name": "홍길동"
}

3. 작은따옴표 사용

Python 딕셔너리를 그대로 복사하면 자주 발생합니다.

4. undefined 사용

JSON.stringify()는 undefined 값을 가진 키를 자동으로 제거합니다.

JSON.stringify({ a: 1, b: undefined })
// 결과: '{"a":1}'  (b가 사라짐)

5. 날짜 처리

JSON에는 Date 타입이 없습니다. ISO 8601 문자열을 사용하세요.

{ "createdAt": "2025-01-15T09:30:00Z" }

JSON 실무 활용 패턴

API 응답 설계

RESTful API에서 일관된 JSON 응답 구조를 사용하면 프론트엔드 개발이 편해집니다.

// 성공 응답
{
  "success": true,
  "data": { "id": 1, "name": "홍길동" },
  "meta": { "page": 1, "total": 100 }
}

// 에러 응답
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "사용자를 찾을 수 없습니다"
  }
}