JSON이 뭔가요? 개발 입문자를 위한 문법 가이드 및 자주 나는 오류 해결법

# JSON이 뭔가요? 개발 입문자를 위한 완벽 가이드

API 통신을 하거나 설정 파일을 다루다 보면 필연적으로 JSON이라는 포맷을 마주하게 됩니다. "그냥 데이터 아닌가?" 하고 대충 넘어가면, 사소한 콤마(,) 하나 때문에 몇 시간을 디버깅하는 지옥을 맛볼 수도 있습니다.

이 글에서는 JSON의 기본 개념부터 개발자들이 자주 겪는 문법 오류, 그리고 해결 방법까지 상세히 알아봅니다.

1. JSON이란? (JavaScript Object Notation)

JSON은 "데이터를 교환하기 위한 경량의 텍스트 포맷"입니다.

이름에 JavaScript가 들어가 있지만, 언어 독립적이라서 Python, Java, C#, Go 등 거의 모든 프로그래밍 언어에서 사용할 수 있습니다.

왜 JSON을 쓰나요?

• 가볍습니다: XML 같은 이전 방식보다 태그가 없어 용량이 작습니다.
• 읽기 쉽습니다: 사람이 읽고 쓰기에 직관적입니다.
• 호환성: 모든 언어에서 파싱(Parsing) 라이브러리를 지원합니다.

2. JSON 기본 문법 (Rules)

JSON은 Key-Value(키-값) 쌍으로 이루어져 있습니다.

json
{
  "name": "텍스터브",
  "version": 1.0,
  "isAlive": true,
  "tags": ["개발", "도구"],
  "owner": {
    "name": "Admin",
    "id": 123
  }
}

반드시 지켜야 할 규칙

• Key는 반드시 큰따옴표("")로 감싸야 합니다.
• - ❌ { name: "texturb" } (틀림)
• - ❌ { 'name': 'texturb' } (작은따옴표 틀림)
• - ✅ { "name": "texturb" } (맞음)
• 문자열 값도 반드시 큰따옴표("")를 씁니다.
• 마지막 항목 뒤에는 콤마(,)를 붙이면 안 됩니다. (Trailing Comma 금지)
• - ❌ { "a": 1, "b": 2, }
• - ✅ { "a": 1, "b": 2 }

3. 자주 발생하는 오류 (Syntax Errors)

개발자가 가장 많이 겪는 JSON 오류 TOP 3입니다.

🔴 Case 1: Trailing Comma (마지막 콤마)

json
{
  "users": [
    { "id": 1 },
    { "id": 2 },  <-- 여기 콤마 있으면 에러!
  ]
}

대부분의 언어 파서(Parser)는 마지막 콤마를 허용하지 않습니다. 배열이나 객체의 마지막 요소 뒤에는 콤마를 빼야 합니다.

🔴 Case 2: 작은따옴표 사용 (Single Quotes)

JavaScript 코드에서는 작은따옴표가 되지만, JSON 표준은 오직 큰따옴표만 허용합니다.

json
{
  'id': 123  <-- 에러!
}

🔴 Case 3: 주석 (Comments)

JSON 표준은 주석(//, / /)을 지원하지 않습니다. 설정 파일로 쓸 때 주석을 넣고 싶다면, JSONC(JSON with Comments) 포맷을 지원하는 파서를 써야 합니다.

JSON은 단순해 보이지만 엄격한 규칙을 가지고 있습니다. "왜 안 되지?" 하고 고민하지 말고, 반드시 검증 도구*를 통해 문법을 체크하는 습관을 들이세요. 여러분의 디버깅 시간을 획기적으로 줄여줄 것입니다.