JSON na YAML w Pythonie
Gotowy do skopiowania kod w Pythonie dla obu kierunków oraz opcje, które zapewniają poprawny wynik.
JSONwejście
YAMLwynik
Każdy wiersz wyniku w domyślnym formatowaniu obok ścieżki wartości, którą zawiera. Kliknij wiersz, aby skopiować ścieżkę.
Działa w całości w przeglądarce: nic nie jest przesyłane. Obowiązują limity uczciwego użytkowania (5 MB na dane wejściowe, ograniczona liczba konwersji), aby zapobiegać spamowi i botom.
JSON na YAML i z powrotem z PyYAML
PyYAML wraz ze standardowym modułem json obsługuje oba kierunki. Te opcje dają najczystszy wynik.
import json
import yaml # pip install pyyaml
with open("data.json", encoding="utf-8") as f:
data = json.load(f)
with open("data.yaml", "w", encoding="utf-8") as f:
yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True) import json
import yaml # pip install pyyaml
with open("data.yaml", encoding="utf-8") as f:
data = yaml.safe_load(f)
with open("data.json", "w", encoding="utf-8") as f:
# default=str turns dates and datetimes into strings
json.dump(data, f, indent=2, ensure_ascii=False, default=str) YAML z wieloma dokumentami i YAML 1.2
Odczytaj każdy dokument z pliku w stylu Kubernetes za pomocą safe_load_all albo użyj ruamel.yaml, aby stosować reguły YAML 1.2 i precyzyjne wcięcia.
import json
import yaml
with open("manifests.yaml", encoding="utf-8") as f:
docs = list(yaml.safe_load_all(f)) # one item per --- document
print(json.dumps(docs, indent=2, default=str)) import json
import sys
from ruamel.yaml import YAML # pip install ruamel.yaml
yaml = YAML() # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)
with open("data.json", encoding="utf-8") as f:
yaml.dump(json.load(f), sys.stdout) Jednolinijkowce w Pythonie
Przydatne w skryptach powłoki i w CI, o ile PyYAML jest zainstalowany.
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml
# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json Typowe problemy i rozwiązania
Niespodzianki, na które najczęściej trafia się przy konwersji z PyYAML. Wybierz jedną, aby zobaczyć ją przed poprawką i po niej.
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| Klucze wychodzą posortowane | safe_dump domyślnie sortuje klucze. | Przekaż sort_keys=False. |
| é staje się "\xE9" | Znaki spoza ASCII są domyślnie zamieniane na sekwencje ucieczki. | Przekaż allow_unicode=True. |
| yes / no / on / off | PyYAML stosuje YAML 1.1, więc no bez cudzysłowu wczytuje się jako False. | Ujmij je w cudzysłowy w YAML albo użyj ruamel.yaml (YAML 1.2). |
| TypeError: datetime is not JSON serializable | safe_load zamienia 2026-10-01 w obiekt date. | Przekaż default=str do json.dump. |
| load() missing Loader | PyYAML 6 wymaga podania Loader dla yaml.load. | Użyj yaml.safe_load, które nigdy nie wykonuje kodu z pliku. |
| Tylko pierwszy dokument | safe_load odczytuje jeden dokument. | Użyj safe_load_all dla plików rozdzielonych przez ---. |
Więcej narzędzi
Konwertery, walidatory i przewodniki krok po kroku dla każdego miejsca, w którym spotykają się JSON i YAML.
Konwertery
Formatowanie i walidacja
Konwersja według zastosowania
- Kubernetes Zamień wynik JSON z kubectl i obiekty API na czyste manifesty gotowe do apply.
- Docker Compose Twórz compose.yaml z JSON, łącznie z portami, zmiennymi środowiskowymi i wolumenami.
- GitHub Actions Pisz pliki workflow z JSON bez pułapki on: / true.
- OpenAPI / Swagger Konwertuj specyfikacje OpenAPI 3 i Swagger 2.0 między JSON a YAML.
- CloudFormation Konwertuj szablony AWS CloudFormation z JSON na YAML, łącznie z funkcjami wewnętrznymi.
Przewodniki: kod i wiersz poleceń
Najczęściej zadawane pytania
Jak przekonwertować JSON na YAML w Pythonie?
Wczytaj JSON za pomocą json.load i zapisz go funkcją yaml.safe_dump z PyYAML: yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). Te dwie opcje zachowują kolejność kluczy i znaki spoza ASCII bez zmian.
Jak przekonwertować YAML na JSON w Pythonie?
Odczytaj plik za pomocą yaml.safe_load i zapisz go przez json.dump(data, f, indent=2, default=str). Użyj yaml.safe_load_all, gdy plik zawiera kilka dokumentów rozdzielonych przez ---.
PyYAML czy ruamel.yaml?
PyYAML to najczęstszy wybór i wystarcza do jednorazowych konwersji. ruamel.yaml implementuje YAML 1.2, zachowuje komentarze i kolejność kluczy przy edycji istniejącego YAML oraz daje dokładniejszą kontrolę nad wcięciami.
Dlaczego safe_load zamiast load?
yaml.load z pełnym loaderem może tworzyć dowolne obiekty Pythona na podstawie tagów w pliku, co jest niebezpieczne dla niezaufanych danych. safe_load tworzy tylko proste typy: słowniki, listy, ciągi znaków, liczby, wartości logiczne, None i daty.
Czy mogę konwertować bez instalowania czegokolwiek?
Tak. Konwerter na górze tej strony działa w przeglądarce i nie wymaga Pythona, pakietów ani przesyłania plików. Wklej JSON lub YAML i skopiuj wynik.