JSON إلى YAML في Python
شيفرة Python جاهزة للنسخ في الاتجاهين، مع الخيارات التي تضمن صحة المخرجات.
JSONالمدخلات
YAMLالمخرجات
كل سطر من الناتج، بالتنسيق الافتراضي، بجانب مسار القيمة التي يحملها. انقر على صف لنسخ المسار.
يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.
من JSON إلى YAML والعكس باستخدام PyYAML
تغطي PyYAML مع الوحدة القياسية json الاتجاهين كليهما. وهذه الخيارات تعطي أنظف مخرجات.
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 متعدد المستندات وYAML 1.2
اقرأ كل مستندات ملف بأسلوب Kubernetes باستخدام safe_load_all، أو استخدم ruamel.yaml لقواعد YAML 1.2 والتحكم الدقيق في المسافة البادئة.
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) أوامر Python من سطر واحد
مفيدة في سكربتات shell وفي CI، ما دامت PyYAML مثبتة.
# 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.
المحوّلات
التنسيق والتحقق
التحويل حسب الاستخدام
- Kubernetes حوّل مخرجات kubectl بصيغة JSON وكائنات API إلى ملفات manifest نظيفة جاهزة للتطبيق.
- Docker Compose أنشئ compose.yaml من JSON، بما في ذلك المنافذ ومتغيرات البيئة ووحدات التخزين.
- GitHub Actions اكتب ملفات سير العمل من JSON دون الوقوع في فخ on: / true.
- OpenAPI / Swagger حوّل مواصفات OpenAPI 3 وSwagger 2.0 بين JSON وYAML.
- CloudFormation حوّل قوالب AWS CloudFormation من JSON إلى YAML، بما في ذلك الدوال الجوهرية (intrinsic functions).
أدلة الشيفرة وسطر الأوامر
الأسئلة الشائعة
كيف أحوّل 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 وانسخ النتيجة.