JSON vs YAML vs TOML: Welches Config-Format sollten Sie verwenden?

JSON, YAML und TOML sind die drei beliebtesten Konfigurationsformate in der Softwareentwicklung. Jedes hat eigene Stärken und Kompromisse. Dieser Leitfaden bietet einen umfassenden Vergleich, um das richtige Format für Ihr Projekt zu wählen.

Konvertieren Sie sofort zwischen JSON und YAML →

Übersicht der Formate

JSON (JavaScript Object Notation)

JSON wurde Anfang der 2000er von Douglas Crockford eingeführt. Es ist der De-facto-Standard für Web-APIs, package.json, tsconfig.json und Datenaustausch.

YAML (YAML Ain't Markup Language)

YAML wurde 2001 vorgeschlagen und für menschliche Lesbarkeit entworfen. Es wird in Docker Compose, Kubernetes, Ansible und CI/CD-Pipelines verwendet.

TOML (Tom's Obvious Minimal Language)

TOML wurde 2013 von Tom Preston-Werner als minimales und eindeutiges Konfigurationsformat erstellt. Standard für Rust (Cargo.toml), Python (pyproject.toml) und Hugo.

Syntaxvergleich

Hier ist die gleiche Konfiguration in allen drei Formaten:

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"

Funktionsvergleich

Wann welches Format verwenden

JSON verwenden, wenn...

// 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 verwenden, wenn...

# 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 verwenden, wenn...

# 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"

Häufige Fallstricke

YAML: Einrückungsprobleme

YAML verwendet Einrückung zur Strukturdefinition. Das Mischen von Tabs und Leerzeichen verursacht häufige Fehler.

# 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: Das "Norwegen-Problem"

In YAML 1.1 werden unquotierte Werte wie NO, yes, on, off als Booleans interpretiert. Der Ländercode "NO" (Norwegen) wird zu 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: Abschließende Kommas

JSON erlaubt keine abschließenden Kommas. Ein Komma nach dem letzten Element verursacht einen Parse-Fehler.

// 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: Verschachtelte Tabellensyntax

Tief verschachtelte Strukturen in TOML können umständlich werden. Jede Ebene benötigt einen eigenen [section.subsection]-Header.

# 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" }

Konvertierungstools

Müssen Sie zwischen Formaten wechseln? Nutzen Sie unsere kostenlosen Konverter:

JSON ↔ YAML Konverter — bidirektionale Konvertierung

TOML ↔ YAML Konverter — sofortige Konvertierung

Konvertieren Sie sofort zwischen JSON und YAML →

Konvertieren Sie zwischen TOML und YAML mit unserem Tool →