YAML na JSON

Czym jest konwersja YAML na JSON?

Konwersja YAML na JSON przekształca dane zapisane w YAML (YAML Ain't Markup Language) do formatu JSON (JavaScript Object Notation). Oba formaty reprezentują dane strukturalne jako pary klucz-wartość, sekwencje i obiekty zagnieżdżone, ale różnią się składnią. YAML używa wcięć i minimalnej interpunkcji, podczas gdy JSON korzysta z nawiasów klamrowych, nawiasów kwadratowych i obowiązkowego cytowania. Konwersja między tymi formatami to typowe zadanie podczas przenoszenia danych konfiguracyjnych między systemami oczekującymi różnych formatów.

YAML został zaprojektowany z myślą o czytelności dla człowieka. Obsługuje komentarze, ciągi wieloliniowe, kotwice i aliasy — żadna z tych funkcji nie istnieje w JSON. Podczas konwersji YAML na JSON te specyficzne dla YAML właściwości są rozwiązywane: kotwice są rozwijane w miejscu, komentarze są odrzucane, a bloki wieloliniowe stają się ciągami z sekwencjami ucieczki. Wynik jest prawidłowym JSON, który może odczytać każdy parser JSON.

Specyfikacja YAML 1.2 wprost definiuje JSON jako podzbiór YAML, co oznacza, że każdy prawidłowy dokument JSON jest również prawidłowym YAML. Odwrotna zasada nie obowiązuje. Dokumenty YAML używające komentarzy, kotwic lub złożonych kluczy nie mają bezpośredniego odpowiednika w JSON i muszą być uproszczone podczas konwersji. Narzędzie obsługuje tę konwersję automatycznie, generując czysty, dobrze sformatowany JSON z dowolnego prawidłowego wejścia YAML.

YAML 1.2 Specification — yaml.org →

Dlaczego używać konwertera YAML na JSON online?

Ręczna konwersja YAML na JSON jest podatna na błędy, szczególnie przy głęboko zagnieżdżonych strukturach lub wartościach wieloliniowych. Konwerter działający w przeglądarce daje wynik natychmiast i wykrywa błędy składni YAML zanim dotrą do Twojej aplikacji.

Przypadki użycia konwersji YAML na JSON

Tabela odwzorowania typów YAML na JSON

Każdy typ danych YAML odwzorowuje się na konkretny typ JSON podczas konwersji. Poniższa tabela przedstawia każdą konstrukcję YAML wraz z odpowiadającym wyjściem JSON. Zrozumienie tych odwzorowań pomaga przewidzieć, jak dane YAML będą wyglądać po konwersji, i unikać niespodzianek z typami takimi jak wartości logiczne czy null.

Składnia YAML a JSON

YAML i JSON reprezentują ten sam model danych, ale przy różnych regułach składni. Różnice poniżej wyjaśniają, dlaczego niektóre funkcje YAML — takie jak komentarze i kotwice — nie mają odpowiednika w JSON.

Przykłady kodu

Poniżej znajdują się działające przykłady programowej konwersji YAML na JSON. Każdy przykład przetwarza ciąg YAML i wyświetla sformatowany JSON.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"gopkg.in/yaml.v3"
)

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

Często zadawane pytania