JSON 기초와 포맷터 사용법 — 개발자 입문 가이드

JSON(JavaScript Object Notation)은 현대 웹 개발에서 가장 널리 쓰이는 데이터 교환 포맷입니다. API 응답, 설정 파일, 데이터베이스 저장 등 거의 모든 곳에서 마주치게 됩니다. 이번 글에서는 JSON의 기초부터 포맷터 활용법까지 한 번에 정리해 드립니다.

JSON의 기본 구조

JSON은 키-값 쌍으로 구성된 텍스트 포맷입니다. 사람이 읽기 쉽고 기계도 파싱하기 쉬워 XML을 거의 대체했습니다.

{
  "name": "김철수",
  "age": 32,
  "isActive": true,
  "skills": ["JavaScript", "Python", "SQL"],
  "address": {
    "city": "서울",
    "zipcode": "04524"
  }
}

JSON이 지원하는 데이터 타입은 다음 6가지입니다.

• 문자열(string): 큰따옴표로 감쌉니다. 작은따옴표는 허용되지 않습니다.
• 숫자(number): 정수와 실수 모두 가능합니다.
• 불리언(boolean): true 또는 false입니다.
• null: 값 없음을 의미합니다.
• 객체(object): 중괄호 안에 키-값 쌍을 나열합니다.
• 배열(array): 대괄호 안에 값을 나열합니다.

자주 발생하는 JSON 오류

오류	원인
Unexpected token	쉼표 누락, 중괄호 짝 맞지 않음
Unexpected end of JSON	문자열이 닫히지 않음
Trailing comma	마지막 요소 뒤 불필요한 쉼표
Invalid string	작은따옴표 사용 또는 이스케이프 누락

JSON 포맷터가 필요한 이유

API 응답은 대개 공백 없이 한 줄로 돌아옵니다. 사람이 직접 읽기에는 너무 어렵죠. 포맷터는 이를 들여쓰기된 읽기 쉬운 형태로 변환해 줍니다.

// 압축된 JSON
{"name":"김철수","age":32,"skills":["JS","Python"]}

// 포맷된 JSON
{
  "name": "김철수",
  "age": 32,
  "skills": ["JS", "Python"]
}

JSON 검증과 디버깅 팁

• 온라인 검증기 활용: 오류 위치를 즉시 알려줍니다.
• 키는 반드시 큰따옴표: 자바스크립트 객체 리터럴과 헷갈리지 마세요.
• 함수·undefined 불가: JSON은 순수 데이터 포맷입니다.
• UTF-8 인코딩 사용: 한글이 깨지지 않도록 반드시 UTF-8로 저장하세요.
• 스키마 검증: JSON Schema로 구조를 사전에 정의할 수 있습니다.

실무에서 JSON 활용 예시

• REST API: 대부분의 웹 API가 JSON으로 응답합니다.
• 설정 파일: package.json, tsconfig.json, .eslintrc.json 등
• NoSQL DB: MongoDB는 BSON(이진 JSON)으로 데이터를 저장합니다.
• 로그 파일: 구조화된 로그는 분석과 검색에 유리합니다.

JSON 포맷터 지금 사용해 보세요

저희 JSON 포맷터는 들여쓰기, 압축, 오류 검증 기능을 모두 제공합니다. 붙여넣기만 하면 즉시 정리된 결과를 볼 수 있으니 개발 작업의 효율을 크게 높일 수 있습니다.