시작하기
기본 구조
JSON은 6개 데이터 타입을 지원합니다: string, number, boolean, null, array, object. 키는 큰따옴표가 붙은 문자열이어야 합니다. JSON은 언어 독립적이며 사람과 기계가 모두 읽기 쉽습니다.
{
"name": "Alice",
"age": 30,
"isStudent": false,
"height": 1.65,
"nullValue": null,
"hobbies": ["reading", "coding", "music"],
"address": {
"city": "NYC",
"zip": "10001"
}
}JSON 문법 규칙
JSON은 엄격한 문법을 갖습니다: 키와 문자열은 큰따옴표만, 쉼표가 요소를 구분하며, 끝 쉼표는 금지입니다. 전체 문서는 단일 JSON 값이어야 합니다. 표준 JSON에는 주석이 없으니 — 필요하면 전처리기나 JSON5를 쓰세요.
{
"key": "value", // key MUST be a double-quoted string
"nested": { "a": 1 }, // objects use { } with comma-separated pairs
"list": [1, 2, 3] // arrays use [ ] with comma-separated values
}
// Rules:
// - Double quotes only for strings and keys (no single quotes)
// - Comma separates members; NO trailing comma
// - The whole document is ONE value (usually an object or array)
// - No comments allowed in standard JSONJSON의 주석
표준 JSON은 주석을 금지합니다. 흔한 우회법: 코드가 무시하는 '_comment' 필드 추가, JSONC/JSON5 사용(VS Code와 많은 도구가 지원), 또는 comment-json이나 JSON.minify 같은 라이브러리로 파싱 전 주석 제거.
// Standard JSON does NOT allow comments.
// Workaround 1: include a descriptive field
{
"_comment": "This is a config file for the app",
"port": 8080
}
// Workaround 2: use JSON5 or JSONC (VS Code settings)
{
// line comment
"port": 8080 /* block comment */
}
// Workaround 3: strip comments before parsing
// (e.g., JSON.minify, comment-json npm package)공백 & 포매팅
문자열 밖의 공백은 무의미합니다 — 컴팩트 형식과 예쁜 형식이 같은 값으로 파싱됩니다. 컴팩트 JSON은 대역폭을 아끼고, 예쁘게 인쇄된 형식(2칸 들여쓰기가 흔함)은 가독성과 diff에 도움됩니다. 대부분의 직렬화기가 'pretty' 옵션을 제공합니다.
// These are all equivalent:
{"a":1,"b":2} // compact (no whitespace)
{ "a": 1, "b": 2 } // readable
{
"a": 1,
"b": 2
} // pretty-printed
// Whitespace between tokens is insignificant.
// Use compact for transmission, pretty for humans.파일 확장자 & MIME 타입
표준 파일 확장자는 .json이고 MIME 타입은 application/json입니다. JSONC, JSON5, GeoJSON, NDJSON 같은 변형은 각자의 관례를 갖습니다. 항상 UTF-8 인코딩을 쓰세요; BOM은 권장되지 않습니다.
// File extensions:
// .json standard JSON
// .jsonc JSON with comments (VS Code, TypeScript config)
// .json5 JSON5 (relaxed syntax)
// .geojson GeoJSON (geographic data)
// .ndjson Newline-Delimited JSON (JSON Lines)
// .har HTTP Archive (JSON-based)
// MIME type:
Content-Type: application/json
// Older/alternate MIME types (avoid):
// text/json (non-standard)
// application/x-json (non-standard)
// UTF-8 is the default and recommended encoding.JSON 값 분류
JSON 값은 여섯 타입으로 나뉩니다: string, number, boolean, null, array, object. 배열과 객체는 구조화되어 있습니다(다른 값을 담을 수 있음); 나머지는 프리미티브입니다. 유효한 JSON 문서는 하나의 값입니다 — 흔히 객체나 배열이지만 맨 숫자나 문자열도 유효합니다.
// A JSON value is exactly one of these six types:
"hello" // string
42 // number
3.14 // number
true // boolean
false // boolean
null // null
[1, 2, 3] // array
{ "a": 1 } // object
// Structured types: array, object
// Primitive types: string, number, boolean, null
// A standalone JSON document is a single value of any type.데이터 타입
String 타입
JSON 문자열은 큰따옴표가 붙은 유니코드 텍스트입니다. 흔한 이스케이프: \"(따옴표), \\(백슬래시), \/(슬래시), \n, \t, \r, \b, \f, 그리고 임의의 유니코드 코드 포인트용 \uXXXX. 작은따옴표는 문자열 구분자로 허용되지 않습니다.
{
"single": "double quotes only",
"empty": "",
"escaped": "He said \"hi\" and C:\\Users",
"unicode": "Cafu00e9 \u00e9 \u1F600",
"multiline": "line1\nline2\ttabbed"
}
// Strings MUST use double quotes.
// Single quotes are NOT valid in JSON.Number 타입
JSON 숫자는 IEEE 754 배정밀도의 부분집합을 따릅니다: 정수, 소수, 과학적 표기(예: 6.022e23). 선행 0은 금지됩니다(007은 무효). NaN, Infinity, -Infinity는 유효하지 않습니다 — 필요하면 null이나 문자열로 인코딩하세요.
{
"integer": 42,
"negative": -7,
"float": 3.14,
"zero": 0,
"scientific": 6.022e23,
"small": 1.5e-10
}
// Numbers are NOT quoted.
// No leading zeros (007 is invalid).
// No NaN, Infinity, or -Infinity (not valid JSON).Boolean 타입
JSON 불리언은 리터럴 키워드 true와 false입니다(소문자, 따옴표 없음). 따옴표가 붙은 'true'/'false'는 문자열입니다. JSON에는 0/1이나 yes/no를 불리언으로 다루는 개념이 없습니다 — 애플리케이션 코드에서 변환하세요.
{
"enabled": true,
"disabled": false,
"flag": true
}
// Booleans are the bare keywords true and false.
// They are NOT quoted ("true" is a string).
// 0/1, yes/no, on/off are NOT booleans in JSON.Null 타입
JSON null은 맨 키워드 null입니다(따옴표 없음). 값의 의도적 부재를 신호합니다. null은 빈 문자열 '', 0, false, 없는 키와 구별됩니다. 많은 언어가 null을 None/nil/null로 매핑합니다.
{
"middleName": null,
"deletedAt": null,
"optional": null
}
// null is a bare keyword (unquoted).
// "null" (quoted) is a string, not null.
// null represents the intentional absence of value.Array 타입
JSON 배열은 [ ]로 감싼 순서 있는 목록이며 쉼표로 구분되고 0 인덱스입니다. 혼합 타입과 중첩 배열/객체를 포함해 어떤 JSON 값이든 담을 수 있습니다. 빈 배열 []도 유효합니다. 순서는 보존되며 의미가 있습니다.
{
"numbers": [1, 2, 3],
"mixed": [1, "two", true, null],
"nested": [[1, 2], [3, 4]],
"objects": [
{ "id": 1 },
{ "id": 2 }
],
"empty": []
}
// Arrays are ordered, zero-indexed, and can hold mixed types.Object 타입
JSON 객체는 { }로 감싼 비순서 키/값 모음입니다. 키는 고유한 큰따옴표 문자열이어야 하고, 값은 어떤 JSON 타입이든 될 수 있습니다. 객체가 개념상 비순서지만 대부분의 파서가 삽입 순서를 유지합니다; 정확성을 위해 순서에 의존하지 마세요.
{
"user": {
"id": 1,
"name": "Alice",
"roles": ["admin", "user"],
"active": true
},
"empty": {}
}
// Objects are unordered collections of key/value pairs.
// Keys MUST be unique strings (double-quoted).
// Values can be any JSON type.문자열
문자열 기본
JSON 문자열은 큰따옴표가 붙은 유니코드 문자의 나열입니다. 슬래시는 이스케이프할 수 있지만(\/) 필요하지는 않습니다 — <script> 태그 안에 JSON을 넣을 때 유용합니다. 빈 문자열도 유효합니다.
{
"name": "Alice",
"email": "[email protected]",
"url": "https://example.com/path?q=1",
"path": "C:\\Users\\alice",
"empty": ""
}
// Strings are double-quoted Unicode text.
// Forward slash may be escaped as \/ but does not have to be.이스케이프 시퀀스
JSON이 지원하는 이스케이프: \"(따옴표), \\(백슬래시), \/(슬래시), \b(백스페이스), \f(폼피드), \n(개행), \r(캐리지 리턴), \t(탭), \uXXXX(유니코드 코드 포인트). 그 외의 백슬래시 시퀀스는 무효입니다.
{
"quote": "She said \"hello\"",
"backslash": "C:\\Users\\name",
"newline": "line1\nline2",
"tab": "col1\tcol2",
"carriage": "a\rb",
"backspace": "a\bb",
"formfeed": "a\fb",
"slash": "a\/b"
}
// Valid escapes: \" \\ \/ \b \f \n \r \t \uXXXX유니코드 문자
임의의 유니코드 코드 포인트에는 \uXXXX를 쓰세요. U+FFFF 위의 문자(많은 이모지처럼)는 서러게이트 쌍이 필요합니다: \u 이스케이프 두 개. 현대 파서는 문자열에 raw UTF-8 문자를 직접 받기도 합니다 — \uXXXX는 주로 안전을 위해, 또는 문자를 입력할 수 없을 때 씁니다.
{
"eacute": "Caf\u00e9",
"euro": "Price: \u20ac10",
"emoji": "Smile \ud83d\ude00",
"chinese": "\u4f60\u597d",
"raw": "Cafu00e9 u00e9 \u00e9"
}
// \uXXXX encodes a code point in the Basic Multilingual Plane.
// Surrogate pairs (two \u escapes) encode characters above U+FFFF.
// Modern parsers also accept the raw UTF-8 character directly.문자열의 특수 문자
JSON 문자열 안에서는 큰따옴표와 백슬래시가 항상 이스케이프되어야 합니다(\"와 \\). 기타 특수 문자(HTML, SQL, 정규식)는 각자의 규칙을 따르지만, JSON은 \"와 \\(그리고 제어 문자)의 이스케이프만 요구합니다. 리터럴 백슬래시는 \\로 씁니다.
{
"html": "<div class=\"x\">Hi</div>",
"sql": "SELECT * FROM t WHERE name='O''Brien'",
"regex": "^\\d{3}-\\d{4}$",
"json": "{ \"k\": \"v\" }",
"cmd": "echo \"hello\""
}
// Backslash is the universal escape character.
// To include a literal backslash, write \\.여러 줄 문자열 (우회법)
JSON 문자열에는 리터럴 개행이 들어갈 수 없습니다 — \n으로 이스케이프해야 합니다. 여러 줄 콘텐츠에는 문자열에 \n을 넣거나, 줄 문자열의 배열을 쓰거나, 여러 줄 문자열을 지원하는 YAML이나 JSON5 같은 형식으로 전환하세요. 이스케이프되지 않은 리터럴 개행은 문법 오류입니다.