تخطي إلى المحتوى
SPCXTools

محول YAML إلى JSON

تحويل ملفات الإعدادات بين YAML و JSON في كلا الاتجاهين، مع التحقق من صحة الصيغة.

تعمل محلياً — ملفاتك لا تغادر جهازك أبداً

جاري تحميل الأداة…

كيفية استخدام محول YAML إلى JSON

  1. 1اختر اتجاه التحويل — YAML → JSON أو JSON → YAML.
  2. 2الصق كود YAML أو JSON في المربع الأيسر، أو انقر على نموذج.
  3. 3تظهر النتيجة المحولة على اليمين أثناء الكتابة. يتم عرض أخطاء الصيغة بالأسفل مع وصف تفصيلي.
  4. 4انسخ النتيجة أو قم بتنزيلها كملف .json أو .yaml. عند تبديل الاتجاه، يتم نقل النتيجة إلى مربع الإدخال.

التحويل بين YAML و JSON

يُعد تنسيقا YAML و JSON الأكثر شيوعاً لملفات الإعدادات والبيانات المهيكلة. تُكتب ملفات Kubernetes و Docker Compose ومسارات CI ومواصفات OpenAPI عادةً بتنسيق YAML، بينما تتطلب واجهات برمجة التطبيقات (APIs) وأكواد JavaScript والعديد من الأدوات تنسيق JSON. يقوم هذا المحول بالتحويل بينهما في كلا الاتجاهين فور كتابتك للنص، ويوضح لك الأخطاء بدقة إذا كان الإدخال غير صالح.

الميزات

  • اتجاهان: من YAML → JSON ومن JSON → YAML، مع إمكانية التبديل بنقرة واحدة.
  • التحقق من صحة الأكواد مع رسائل خطأ واضحة للمسافات البادئة الخاطئة، وعلامات الاقتباس غير المغلقة، وأكواد JSON غير الصالحة.
  • تحويل مستندات YAML المتعددة إلى مصفوفة JSON.
  • معالجة تلقائية للروابط والأسماء المستعارة ومفاتيح الدمج.
  • مسافات بادئة بمقدار 2 أو 4 مسافات للمخرجات.
  • نسخ أو تنزيل النتيجة بصيغة .json أو .yaml.
  • الخصوصية: لا يتم إرسال أي شيء إلى الخادم.

مثال

كود YAML هذا:

name: web-app
replicas: 3
ports:
  - 80
  - 443
env:
  NODE_ENV: production

يتحول إلى كود JSON هذا:

{
  "name": "web-app",
  "replicas": 3,
  "ports": [80, 443],
  "env": {
    "NODE_ENV": "production"
  }
}

أخطاء YAML الشائعة

  • استخدام علامات الجدولة (Tabs) للمسافة البادئة. لا يسمح YAML إلا باستخدام المسافات. استبدل علامات الجدولة بمسافتين.
  • عدم تناسق المسافات البادئة. يجب أن تحتوي العناصر المرتبطة ببعضها على نفس مقدار المسافة البادئة تمامًا.
  • نسيان المسافة بعد النقطتين. تُقرأ key:value كنص واحد؛ اكتبها هكذا key: value.
  • رموز خاصة في النصوص. القيم التي تبدأ بـ @، *، &، !، %، { أو [، أو تحتوي على : ، يجب وضعها بين علامتي تنصيص.
  • أنواع بيانات غير متوقعة. أرقام الإصدارات مثل 1.10 تتحول إلى الرقم 1.1، وقد تُفقد الأصفار البادئة. ضع القيم التي يجب أن تبقى كنص بين علامتي تنصيص.

أدوات ذات صلة

يمكنك تنسيق أو تصغير كود JSON الناتج باستخدام منسق JSON، أو تحويل JSON إلى جدول بيانات باستخدام تحويل JSON إلى CSV، أو مقارنة ملفي إعدادات باستخدام أداة مقارنة النصوص.

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

ما الفرق بين YAML و JSON؟
كلاهما يصف نفس أنواع البيانات — الكائنات، القوائم، السلاسل النصية، الأرقام، القيم المنطقية والقيمة الفارغة (null). يستخدم JSON الأقواس وعلامات الاقتباس وهو المعيار المعتمد لواجهات برمجة التطبيقات (APIs). بينما يعتمد YAML على المسافات البادئة بدلاً من الأقواس، ويسمح بإضافة التعليقات، ويشيع استخدامه في ملفات الإعدادات مثل Docker Compose و Kubernetes و GitHub Actions و Ansible.
ماذا يحدث لتعليقات YAML؟
لا يدعم JSON التعليقات، لذا يتم تجاهلها عند تحويل YAML إلى JSON. وعند التحويل العكسي، لن يحتوي ملف YAML على التعليقات الأصلية.
كيف يتم التعامل مع مستندات YAML المتعددة؟
يمكن أن يحتوي ملف YAML على عدة مستندات مفصولة بـ ---. في هذه الحالة، تُصدر أداة التحويل مصفوفة JSON تحتوي على عنصر واحد لكل مستند.
هل الروابط (anchors) والأسماء المستعارة (aliases) مدعومة؟
نعم. تتم معالجة الروابط (&name) والأسماء المستعارة (*name) ومفاتيح الدمج (<<: *name)، بحيث يحتوي JSON الناتج على القيم الموسعة بالكامل.
لماذا يتغير نوع القيمة الخاصة بي، مثل تحول "no" إلى false؟
تتبع هذه الأداة معيار YAML 1.2، حيث تُعتبر true و false فقط قيماً منطقية. بينما تعامل أدوات التحليل الأقدم لمعيار YAML 1.1 أيضاً yes و no و on و off كقيم منطقية. إذا أردت الاحتفاظ بالقيمة كسلسلة نصية، ضعها بين علامتي اقتباس.
هل يتم رفع بياناتي؟
لا. تتم عملية التحليل والتحويل بالكامل داخل متصفحك، لذا فإن ملفات الإعدادات التي تحتوي على بيانات سرية أو أسماء نطاقات داخلية لا تغادر جهازك أبداً.