JSONKit

© 2024 JSONKit

JSONKit
블로그

JSON 포맷 완벽 가이드: 구조, 문법, 활용법

JSON(JavaScript Object Notation)은 현대 웹 개발에서 가장 널리 사용되는 데이터 교환 형식입니다. API 통신, 설정 파일, 데이터 저장 등 거의 모든 곳에서 JSON을 만날 수 있습니다. 이 가이드에서는 JSON의 기본 구조부터 실무 활용 팁까지 체계적으로 알아봅니다.

JSON이란?

JSON은 2001년 Douglas Crockford가 제안한 경량 데이터 교환 형식입니다. 사람이 읽고 쓰기 쉬우면서도 기계가 파싱하고 생성하기 용이하도록 설계되었습니다. 현재 RFC 8259로 표준화되어 있으며, 프로그래밍 언어에 독립적입니다.

JSON의 기본 데이터 타입

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

1. 문자열 (String)

큰따옴표(")로 감싸야 합니다. 작은따옴표는 허용되지 않습니다.

{
  "name": "홍길동",
  "message": "줄바꿈은 \\n으로 표현합니다"
}

2. 숫자 (Number)

정수와 부동소수점 모두 지원합니다. 따옴표 없이 작성합니다.

{
  "age": 30,
  "pi": 3.14159,
  "scientific": 1.5e10
}

3. 불리언 (Boolean)

true 또는 false만 허용됩니다. 따옴표 없이 소문자로 작성합니다.

{
  "isActive": true,
  "isDeleted": false
}

4. null

값이 없음을 나타냅니다. 소문자 null만 유효합니다.

{
  "middleName": null
}

5. 객체 (Object)

중괄호 {}로 감싸고, 키-값 쌍을 쉼표로 구분합니다. 키는 반드시 문자열이어야 합니다.

{
  "user": {
    "id": 1,
    "name": "김개발",
    "email": "dev@example.com"
  }
}

6. 배열 (Array)

대괄호 []로 감싸고, 요소를 쉼표로 구분합니다. 서로 다른 타입을 혼합할 수 있습니다.

{
  "tags": ["javascript", "json", "web"],
  "mixed": [1, "two", true, null]
}

자주 하는 실수

후행 쉼표 (Trailing Comma)

JavaScript에서는 허용되지만 JSON에서는 금지됩니다.

// 잘못된 예
{ "a": 1, "b": 2, }


// 올바른 예
{ "a": 1, "b": 2 }

주석 사용

JSON은 주석을 지원하지 않습니다. //나 /* */ 모두 사용할 수 없습니다.

작은따옴표 사용

키와 문자열 값 모두 반드시 큰따옴표를 사용해야 합니다.

// 잘못된 예
{ 'name': 'test' }


// 올바른 예
{ "name": "test" }

JSON 포맷팅이 중요한 이유

가독성

들여쓰기와 줄바꿈이 적용된 JSON은 구조를 한눈에 파악할 수 있습니다. 디버깅 시간을 크게 단축시켜 줍니다.

파일 크기 최적화

프로덕션 환경에서는 공백을 제거한 압축(Minify) JSON을 사용하면 네트워크 전송량을 줄일 수 있습니다. 대용량 API 응답의 경우 30~50% 크기 절감 효과가 있습니다.

일관성 유지

팀 프로젝트에서는 들여쓰기 규칙(2칸 vs 4칸)을 통일하는 것이 코드 리뷰와 버전 관리에 도움됩니다.

실무 팁

  1. API 응답 디버깅: Beautify를 사용해 API 응답을 정리하면 데이터 구조를 빠르게 파악할 수 있습니다.
  2. 설정 파일 관리: package.json, tsconfig.json 등의 설정 파일은 항상 포맷팅된 상태를 유지하세요.
  3. 데이터 검증: JSON을 다른 시스템에 전달하기 전에 반드시 유효성 검사를 수행하세요.
  4. 큰 파일 처리: 대용량 JSON 파일은 트리 뷰어를 활용하면 구조를 쉽게 탐색할 수 있습니다.

마무리

JSON은 단순하지만 올바르게 사용하려면 규칙을 정확히 알아야 합니다. JSONKit의 Beautify 도구를 활용하면 JSON 포맷팅, 압축, 검증을 한 번에 처리할 수 있습니다.

beautify 도구 사용해보기