JSON إلى YAML في Python

شيفرة Python جاهزة للنسخ في الاتجاهين، مع الخيارات التي تضمن صحة المخرجات.

خيارات المخرجات

JSONالمدخلات

فارغ

YAMLالمخرجات

تظهر مخرجات YAML هنا

يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.

تحميل من URL

يجلب متصفحك الملف مباشرةً، لذا يجب أن يسمح الخادم بالطلبات عبر المصادر (cross-origin).

اختصارات لوحة المفاتيح

Ctrl / ⌘ + Enter التحويل الآن
Ctrl / ⌘ + S تنزيل المخرجات
Alt + Shift + C نسخ المخرجات
Alt + Shift + F إصلاح مدخلات JSON وتنسيقها
Alt + Shift + S تبديل الاتجاه
Alt + Shift + T التبديل بين عرض الشيفرة والشجرة والخريطة
Ctrl / ⌘ + Z تراجع، بما في ذلك «تنسيق» و«إصلاح» و«مسح»
Esc الخروج من ملء الشاشة
حجم النص في المحرّر

من JSON إلى YAML والعكس باستخدام PyYAML

تغطي PyYAML مع الوحدة القياسية json الاتجاهين كليهما. وهذه الخيارات تعطي أنظف مخرجات.

json_to_yaml.py
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)
yaml_to_json.py
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 متعدد المستندات وYAML 1.2

اقرأ كل مستندات ملف بأسلوب Kubernetes باستخدام safe_load_all، أو استخدم ruamel.yaml لقواعد YAML 1.2 والتحكم الدقيق في المسافة البادئة.

all_documents.py
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))
ruamel_dump.py
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)

أوامر Python من سطر واحد

مفيدة في سكربتات shell وفي CI، ما دامت PyYAML مثبتة.

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

مشكلات شائعة وحلولها

المفاجآت الأكثر شيوعًا عند التحويل باستخدام PyYAML. اختر واحدة لتراها قبل الإصلاح وبعده.

العَرَضالسببالإصلاح
تخرج المفاتيح مرتّبة ترتّب safe_dump المفاتيح افتراضيًا. مرّر sort_keys=False.
يصبح é "\xE9" تُهرَّب الأحرف غير ASCII افتراضيًا. مرّر allow_unicode=True.
yes / no / on / off تتبع PyYAML معيار YAML 1.1، لذا تُحمَّل no غير المقتبسة على أنها False. اقتبسها في YAML، أو استخدم ruamel.yaml (YAML 1.2).
TypeError: datetime is not JSON serializable تحوّل safe_load القيمة 2026-10-01 إلى كائن تاريخ. مرّر default=str إلى json.dump.
load() missing Loader تشترط PyYAML 6 تمرير Loader إلى yaml.load. استخدم yaml.safe_load، التي لا تشغّل أبدًا شيفرة من الملف.
المستند الأول فقط تقرأ safe_load مستندًا واحدًا. استخدم safe_load_all للملفات المفصولة بـ ---.

مزيد من الأدوات

محوّلات ومدقّقات وأدلة خطوة بخطوة لكل موضع يلتقي فيه JSON وYAML.

الأسئلة الشائعة

كيف أحوّل JSON إلى YAML في Python؟

حمّل JSON باستخدام json.load واكتبه باستخدام yaml.safe_dump من PyYAML: yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). يحافظ الخياران على ترتيب مفاتيحك والأحرف غير ASCII كما هي.

كيف أحوّل YAML إلى JSON في Python؟

اقرأ الملف باستخدام yaml.safe_load واكتبه باستخدام json.dump(data, f, indent=2, default=str). واستخدم yaml.safe_load_all عندما يحتوي الملف على عدة مستندات مفصولة بـ ---.

هل أستخدم PyYAML أم ruamel.yaml؟

PyYAML هي الخيار الأكثر شيوعًا وتكفي لعمليات التحويل لمرة واحدة. أما ruamel.yaml فتطبّق YAML 1.2، وتحافظ على التعليقات وترتيب المفاتيح عند تحرير YAML موجود، وتمنح تحكمًا أدق في المسافة البادئة.

لماذا أستخدم safe_load بدلًا من load؟

يمكن لـ yaml.load مع المحمّل الكامل إنشاء كائنات Python عشوائية من الوسوم الموجودة في الملف، وهذا غير آمن مع المدخلات غير الموثوقة. أما safe_load فلا تبني إلا أنواعًا بسيطة: القواميس والقوائم والسلاسل النصية والأعداد والقيم المنطقية وNone والتواريخ.

هل يمكنني التحويل دون تثبيت أي شيء؟

نعم. يعمل المحوّل أعلى هذه الصفحة داخل متصفحك ولا يحتاج إلى Python أو حزم أو رفع. الصق JSON أو YAML وانسخ النتيجة.