JSON vs YAML: rozdiely a prípady použitia

JSON a YAML sú dva najpoužívanejšie textové serializačné formáty na popis štruktúrovaných dát: aplikačná konfigurácia, API payload, infraštrukturálne súbory, Kubernetes manifests, CI/CD pipelines. Oba reprezentujú rovnaké základné štruktúry (objekty, zoznamy, skaláre), ale s odlišnými filozofiami: JSON preferuje strojovú čitateľnosť a univerzalitu, YAML sa stavia na ľudskej čitateľnosti a stručnosti. Tento článok porovnáva oba formáty bod po bode, aby vám pomohol s výberom.

Čo je JSON?

JSON (JavaScript Object Notation) je serializačný formát uvedený Douglasom Crockfordom na začiatku 2000 rokov, odvodený z JavaScript literálnej syntaxe objektu. Štandardizovaný RFC 8259 a ECMA-404, je dnes pivot formát webu: takmer všetky REST API, NoSQL databázy a frontend konfigurácie ho používajú.

JSON spočíva na dvoch štruktúrach:

• Usporiadaná kolekcia dvojíc kľúč-hodnota (objekt, medzi zloženými zátvorkami)
• Usporiadaný zoznam hodnôt (pole, medzi hranatými zátvorkami)

Skalárne hodnoty sú string, number, true, false alebo null. Reťazce sú povinne obklopené dvojitými úvodzovkami. JSON nepodporuje komentáre.

Čo je YAML?

YAML (YAML Ain't Markup Language) je formát objavený v 2001, navrhnutý od počiatku byť čitateľný človekom. Súčasná špecifikácia je YAML 1.2.2. Jeho rozlišovacia charakteristika: používa odsadenie na vyjadrenie hierarchie, ako Python.

YAML je nadmnožinou JSON od verzie 1.2: akýkoľvek validný JSON dokument je validný YAML dokument. Ale YAML pridáva veľa: komentáre, reťazce bez úvodzoviek, viacriadkové, anchors a aliasy, tags na explicitné typovanie, viacnásobné dokumenty v jedinom súbore (---).

Porovnaná syntax

Tu je rovnaká štruktúra vyjadrená v oboch formátoch.

JSON

{
  "name": "cdrn",
  "version": "1.14",
  "tags": ["seo", "tools", "open-source"],
  "author": {
    "name": "Adrien",
    "email": "contact@example.com"
  },
  "active": true,
  "stars": null
}

YAML

# Konfiguracia projektu
name: cdrn
version: "1.14"
tags:
  - seo
  - tools
  - open-source
author:
  name: Adrien
  email: contact@example.com
active: true
stars: null

Na rovnakom obsahu YAML zaberá približne rovnaký počet riadkov, ale vyhýba sa zloženým zátvorkám, hranatým zátvorkám, koncovým čiarkam a úvodzovkám na väčšine reťazcov. Komentáre (riadky #) sú povolené.

Podporované typy

JSON pozná 6 typov: object, array, string, number, boolean, null. Žiadny natívny dátum, žiadny binárny, žiadny explicitný rozdiel integer/float.

YAML 1.2 pozná rovnaké ako JSON a pridáva: ISO 8601 timestampy, binárne (kódované base64 cez tag !!binary), odlišné integery a floaty, nekonečno, NaN a vlastné typy cez tagy (!!str, !!int, !!float...). YAML 1.1 akceptoval yes/no/on/off ako booleany: klasická pasť na starých parseroch.

Výkon a ekosystém

JSON je typicky 3 až 10krát rýchlejší na parsovanie ako YAML a jeho parsery sú dostupné všade (integrované v runtime takmer všetkých jazykov). YAML knižnice sú ťažšie, pretože spravujú bohatšiu gramatiku (anchors, tags, multi-doc).

Na strane ekosystému: JSON dominuje HTTP API, NoSQL databázy (MongoDB, CouchDB), súbory package.json, composer.json, tsconfig.json. YAML sa presadil pre aplikačnú konfiguráciu a infrastructure-as-code: Symfony, Spring Boot, Rails, Docker Compose, Kubernetes, GitHub Actions, GitLab CI, Ansible.

Porovnávacia tabuľka

Typické prípady použitia

Zvoliť JSON, keď

• Navrhujete REST API alebo webhook endpoint
• Ukladáte dáta v NoSQL databáze alebo cache
• Vymieňate dáta medzi frontendom a backendom
• Parsovací výkon je kritický (vysoká priepustnosť, edge)
• Chcete univerzálne podporovaný formát bez závislosti

Zvoliť YAML, keď

• Píšete aplikačnú konfiguráciu editovanú ručne
• Potrebujete komentáre na dokumentáciu volieb
• Píšete Kubernetes, Docker Compose, GitHub Actions, Ansible
• Chcete faktorovať bloky s anchors a aliasmi
• Čitateľnosť prevažuje nad rýchlosťou spracovania

Odporúčanie

Jednoduché pravidlo: JSON pre stroj, YAML pre človeka. Ak je váš súbor produkovaný alebo konzumovaný programom, vezmite JSON. Ak je písaný a čítaný ručne, vezmite YAML. Mnoho ekosystémov akceptuje oba: Symfony číta YAML, JSON a XML pre svoje konfigurácie, Kubernetes akceptuje oba pre svoje manifests. V pochybnostiach začnite s YAML pre ľudskú konfiguráciu a JSON pre automatizované toky.

Konverziu z jedného formátu do druhého môžete testovať naším JSON / YAML konvertorom a rýchlo naformátovať dokument JSON formátorom.

Často kladené otázky