Konwertuj między JSON i YAML

To narzędzie przekształca dokument YAML w JSON i odwrotnie, zachowując strukturę danych (obiekty, tablice, typy skalarne). Konwersja JSON na YAML lub YAML na JSON to częsta operacja w programowaniu: generuje się plik OpenAPI YAML ze specyfikacji JSON, konwertuje wyjście API REST na YAML, aby zacommitować je w repozytorium konfiguracji, tłumaczy manifest Kubernetes YAML na JSON, aby przekazać go do kubectl --dry-run=client -o json, lub wyrównuje workflow GitHub Actions ze schematem JSON. Szerzej, to most między światem wymiany danych (JSON) a światem ręcznie edytowanej konfiguracji (YAML).

JSON i YAML adresują podobne potrzeby, ale różne przypadki użycia. Poniższa tabela podsumowuje główne różnice techniczne, przydatne do wyboru między nimi w zależności od kontekstu.

JSON nadaje się, gdy program komunikuje się z innym programem. Jego typowe przypadki użycia:

• API REST i GraphQL: payloady żądań i odpowiedzi.
• Wymiana danych między mikroserwisami i kolejkami wiadomości.
• Natywny kod JavaScript: JSON.parse i JSON.stringify bez zależności.
• Przechowywanie po stronie przeglądarki: localStorage, sessionStorage, IndexedDB.
• Żądania AJAX i fetch.
• Warianty binarne lub strumieniowe: BSON (MongoDB), JSON Lines (logi, datasety ML), MessagePack.
• Konfiguracja narzędzi JS / TS: package.json, tsconfig.json, composer.json.

YAML nadaje się, gdy człowiek regularnie edytuje plik. Jego typowe przypadki użycia:

• Docker Compose (docker-compose.yml) i profile stacków.
• Manifesty Kubernetes (Deployment, Service, Ingress, Helm charts).
• Playbooki Ansible i inwentarze.
• Pipeliny CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Specyfikacje OpenAPI / Swagger i AsyncAPI.
• Konfiguracja aplikacyjna z adnotacjami (Symfony, Spring Boot, Rails), gdzie komentarze są przydatne.
• Pliki edytowane często ręcznie, gdzie zwięzłość i czytelność mają pierwszeństwo nad szybkością parsowania.

YAML jest bardziej permisywny niż JSON, co czyni go potężnym, ale podstępnym formatem. Najczęstsze pułapki:

• Wcięcie: tabulacje są zabronione przez specyfikację, tylko spacje są prawidłowe. Mieszanie obu lub zmiana liczby spacji w tym samym bloku psuje parsowanie.
• Automatyczna koercja skalarów: yes, no, on, off, true, false, null, None, ~ są parsowane jako booleany lub null. Przykład pułapki: kod pocztowy 01234 bez cudzysłowów staje się liczbą całkowitą 1234, a nazwa kraju NO (Norwegia) staje się false. Zawsze umieszczaj w cudzysłowach niejednoznaczne ciągi.
• Stringi wielolinijkowe: | (block literal) zachowuje znaki nowej linii bez zmian, podczas gdy > (folded) zastępuje znaki nowej linii spacjami. Wskaźniki chomping - i + dostosowują zachowanie ostatniego znaku nowej linii.
• YAML 1.1 vs 1.2: 1.1 (wciąż bardzo rozpowszechniona, na przykład przez PyYAML domyślnie) traktuje yes/no/on/off jako booleany, co 1.2 usunęła. Zachowania różnią się też dla liczb w systemie ósemkowym.
• Implicytne daty: 2024-01-15 bez cudzysłowów jest interpretowane jako obiekt daty przez niektóre parsery, a nie jako ciąg.

Ten sam dokument wyrażony w JSON, a następnie w YAML. Prosta konfiguracja aplikacji z jej zależnościami i środowiskiem:

Wersja JSON

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Równoważna wersja YAML

# Configuration de l'application
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

Wersja YAML jest o około 25% krótsza w znakach, akceptuje komentarz na początku i czyta się jak listę właściwości bez składniowego szumu.

Kroki do konwersji twoich danych:

1. Wklej swój dokument źródłowy (JSON lub YAML) w polu wprowadzania.
2. Wybierz pożądany kierunek konwersji (JSON na YAML lub YAML na JSON).
3. Kliknij przycisk konwersji: sformatowany wynik pojawia się w obszarze wyjścia.
4. Sprawdź rendering, a następnie użyj przycisku kopiowania, aby przenieść wynik do schowka.

Konwersja jest wykonywana lokalnie w twojej przeglądarce lub przez dedykowaną trasę serwera, w zależności od tooling: żadne wrażliwe dane nie są przechowywane.