JSON vs YAML vs TOML: 어떤 설정 포맷을 사용해야 할까?

JSON, YAML, TOML은 소프트웨어 개발에서 가장 널리 사용되는 3가지 설정 형식입니다. 각각 다른 강점과 트레이드오프가 있습니다. 이 가이드는 프로젝트에 적합한 형식을 선택하는 데 도움이 되는 포괄적인 비교를 제공합니다.

무료 도구로 JSON과 YAML을 즉시 변환 →

각 형식 개요

JSON (JavaScript Object Notation)

JSON은 2000년대 초반 Douglas Crockford에 의해 도입되었습니다. 웹 API, package.json, tsconfig.json 등의 사실상 표준입니다.

YAML (YAML Ain't Markup Language)

YAML은 2001년에 제안되었으며 인간 가독성을 위해 설계되었습니다. Docker Compose, Kubernetes, Ansible, CI/CD 파이프라인에서 널리 사용됩니다.

TOML (Tom's Obvious Minimal Language)

TOML은 2013년 Tom Preston-Werner가 만든 최소한이며 모호하지 않은 설정 형식입니다. Rust(Cargo.toml), Python(pyproject.toml), Hugo의 표준입니다.

구문 비교

동일한 설정을 3가지 형식으로 표현합니다:

JSON

{
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "host": "db.example.com",
    "port": 5432,
    "name": "myapp",
    "credentials": {
      "username": "admin",
      "password": "secret"
    }
  },
  "features": ["auth", "logging", "cache"],
  "max_connections": 100
}

YAML

# Server configuration
server:
  host: localhost
  port: 8080
  debug: true

# Database settings
database:
  host: db.example.com
  port: 5432
  name: myapp
  credentials:
    username: admin
    password: secret

features:
  - auth
  - logging
  - cache

max_connections: 100

TOML

# Server configuration
max_connections = 100
features = ["auth", "logging", "cache"]

[server]
host = "localhost"
port = 8080
debug = true

[database]
host = "db.example.com"
port = 5432
name = "myapp"

[database.credentials]
username = "admin"
password = "secret"

기능 비교

각 형식의 사용 시기

JSON을 사용할 때...

// Typical JSON use cases
// package.json
{
  "name": "my-app",
  "version": "1.0.0",
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  }
}

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "strict": true
  }
}

YAML을 사용할 때...

# Docker Compose
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html

# GitHub Actions
name: CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

TOML을 사용할 때...

# Cargo.toml (Rust)
[package]
name = "my-app"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

# pyproject.toml (Python)
[project]
name = "my-package"
version = "1.0.0"
requires-python = ">=3.9"

[tool.ruff]
line-length = 88
target-version = "py39"

흔한 함정

YAML: 들여쓰기 문제

YAML은 들여쓰기로 구조를 정의합니다. 탭과 스페이스를 혼용하거나 들여쓰기 레벨이 일관되지 않으면 오류가 발생합니다.

# BAD: mixing tabs and spaces (invisible but breaks YAML)
services:
	web:          # tab character - YAML error!
    image: nginx

# BAD: inconsistent indentation
services:
  web:
      image: nginx   # 4 spaces here
    ports:            # 2 spaces here - error!
      - "80:80"

# GOOD: consistent 2-space indentation
services:
  web:
    image: nginx
    ports:
      - "80:80"

YAML: "노르웨이 문제"

YAML 1.1에서 따옴표 없는 NO, yes, on, off는 불리언 값으로 해석됩니다. 국가 코드 "NO"(노르웨이)는 false가 됩니다.

# The "Norway Problem" - YAML 1.1
countries:
  - name: Norway
    code: NO          # Parsed as boolean false!
  - name: Sweden
    code: SE          # Parsed as string "SE"
  - name: Finland
    code: FI          # Parsed as string "FI"

# Other surprising boolean values in YAML 1.1:
truthy:  yes          # boolean true
falsy:   no           # boolean false
enabled: on           # boolean true
disabled: off         # boolean false
positive: TRUE        # boolean true
negative: False       # boolean false

# FIX: Always quote values that could be misinterpreted
countries:
  - name: Norway
    code: "NO"        # Now correctly a string
  - name: Sweden
    code: "SE"
settings:
  enabled: "yes"      # Now correctly a string

JSON: 후행 콤마

JSON은 후행 콤마를 허용하지 않습니다. 마지막 요소 뒤에 콤마를 추가하면 파싱 오류가 발생합니다.

// BAD: trailing comma after last element
{
  "name": "my-app",
  "version": "1.0.0",
  "private": true,    // <-- trailing comma = PARSE ERROR
}

// BAD: trailing comma in array
{
  "colors": [
    "red",
    "green",
    "blue",            // <-- trailing comma = PARSE ERROR
  ]
}

// GOOD: no trailing commas
{
  "name": "my-app",
  "version": "1.0.0",
  "private": true
}

TOML: 중첩 테이블 구문

TOML에서 깊은 중첩 구조는 장황해질 수 있습니다. 각 레벨에 자체 [section.subsection] 헤더가 필요합니다.

# TOML: deeply nested config can be verbose
[server]
host = "localhost"

[server.ssl]
enabled = true

[server.ssl.certificates]
cert = "/path/to/cert.pem"
key = "/path/to/key.pem"

[server.ssl.certificates.ca]
bundle = "/path/to/ca-bundle.pem"

# The same in YAML is more compact:
# server:
#   host: localhost
#   ssl:
#     enabled: true
#     certificates:
#       cert: /path/to/cert.pem
#       key: /path/to/key.pem
#       ca:
#         bundle: /path/to/ca-bundle.pem

# TOML inline tables can help for shallow nesting:
[server]
host = "localhost"
ssl = { enabled = true, cert = "/path/to/cert.pem" }

변환 도구

형식 간 전환이 필요하신가요? 무료 온라인 변환기를 사용하세요:

JSON ↔ YAML 변환기—양방향 변환 지원

TOML ↔ YAML 변환기—즉시 변환

무료 도구로 JSON과 YAML을 즉시 변환 →

무료 도구로 TOML과 YAML을 변환 →