محوّل YAML إلى JSON
حوّل YAML إلى JSON أو العكس مع إمكانية ضبط المسافة البادئة. يدعم الخرائط المتداخلة والقوائم والنصوص متعددة الأسطر ويوضح موضع خطأ الصياغة بدقة.
حوّل YAML إلى JSON أو JSON إلى YAML مع إمكانية ضبط المسافة البادئة. وتُعالَج الخرائط المتداخلة والقوائم والنصوص بين علامات تنصيص والكتل النصية متعددة الأسطر والمراسي (anchors)، ويُبلَّغ عن أي مشكلة في الصياغة مع الموضع الذي سبّبها بدلاً من الفشل الصامت.
وهذا هو الجسر اليومي بين الصيغتين: فملف إعدادات Kubernetes أو CI المكتوب بـ YAML يجب أن يصبح JSON لاستدعاء API، أو أن حِملاً بصيغة JSON يحتاج إلى تحرير يدوي، وهو أسهل بكثير في YAML. ويجري التحويل في متصفحك، فلا تغادر ملفات الإعدادات التي تضم رموز وصول أو أسماء مضيفات داخلية جهازك أبداً.
كيفية التحويل بين YAML وJSON
الصق YAML أو JSON
اختر اتجاه التحويل والمسافة البادئة
انسخ النتيجة المحوَّلة
الأسئلة الشائعة
ما الاتجاهات المدعومة؟
كلاهما: من YAML إلى JSON ومن JSON إلى YAML. وJSON مجموعة فرعية من YAML، فيتحول أي JSON صالح بسلاسة دائماً، أما YAML فيستخدم ميزات لا يملكها JSON، وتُوسَّع هذه الميزات عند التحويل.
ماذا يحدث للتعليقات في YAML؟
التعليقات ليست جزءاً من نموذج البيانات، فتُحذف عند التحويل إلى JSON. واحتفظ بالملف الأصلي مرجعاً إن كانت التعليقات مهمة.
هل تُحفظ النصوص متعددة الأسطر؟
نعم، تتحول الكتل النصية والنصوص الحرفية إلى نصوص عادية في JSON، مع الإبقاء على فواصل الأسطر كأحرف سطر جديد مُهرَّبة.
لماذا يفشل تحليل YAML لديّ؟
الأسباب المعتادة هي مسافة بادئة غير متسقة، أو حرف جدولة (Tab) بدلاً من المسافات، أو نقطتان بغير علامتي تنصيص داخل قيمة. وتشير رسالة الخطأ إلى السطر والعمود الذي توقف عنده التحليل.
هل تتعامل مع ملفات إعدادات كبيرة؟
نعم، تُحوَّل ملفات بحجم بضعة ميجابايت في الحال. والحد العملي هو ذاكرة جهازك، وكل شيء يُعالَج محلياً.
هل تُرفع إعداداتي؟
لا. وهذا مهم لأن ملفات الإعدادات كثيراً ما تضم بيانات اعتماد ورموز وصول وأسماء مضيفات داخلية.
نظرة سريعة
| المدخل | نص |
|---|---|
| عدة ملفات | لا |
| مكان التشغيل | في متصفحك، ولا تُرفع الملفات أبداً |
| يعمل دون اتصال | نعم — بعد تحميل الصفحة |
| السعر | مجاني، بلا تسجيل وبلا علامة مائية |
اختيار صيغة البيانات
JSON هو الصيغة الافتراضية لكل ما تُرجعه واجهة API أو يقرأه برنامج: فهو يتعامل بطبيعته مع البنى المتداخلة والأرقام والقيم المنطقية وnull، وكل لغة تحلّله. أما CSV فأصغر حجماً ويُفتح مباشرة في جدول بيانات، لكنه لا يملك وسيلة للتعبير عن التداخل ولا معياراً مشتركاً للفاصل أو التنصيص أو مجموعة المحارف، وهذا بالضبط موضع الخطأ في التحويلات. أما XML فمطوّل لكنه يحمل السمات والمحتوى المختلط والمخططات، ولذلك ما زال مهيمناً على صيغ المستندات والتكاملات القديمة. وYAML هو الأسهل قراءةً في الإعدادات لكنه حساس للمسافات البيضاء وفيه إكراه مفاجئ للأنواع («no» تصبح false، وإصدار مثل 1.10 يصبح 1.1). فاختر الصيغة التي تفضّلها الأداة المستهلكة لا الصيغة الأجمل منظراً.
أين تنكسر التحويلات بهدوء
معظم أخطاء التحويل لا تتعلق بالصياغة بل بالمعنى. فعمود من الرموز البريدية في ملف CSV يفقد أصفاره البادئة في اللحظة التي يخمّن فيها جدول البيانات أنه رقم؛ ومعرّف طويل يتجاوز دقة الفاصلة العائمة؛ والتواريخ يتغير معناها بحسب ما إذا كان اليوم أولاً أم الشهر أولاً. ومفاتيح JSON غير مرتبة أما المصفوفات فمرتبة، والأداة التي ترتب المفاتيح لا تغيّر شيئاً بينما التي ترتب المصفوفات تغيّر البيانات. وUnicode فخ آخر: فقد يصل النص بترميز UTF-8 أو UTF-16 أو مع علامة ترتيب البايتات، وفاكّ الترميز الذي يخمّن خطأً يحوّل المحارف المشكّلة إلى نص مشوّه. وقبل أن تثق بأي تحويل، افحص الصف الأول والأخير، وكل حقل فيه أصفار بادئة، وكل حقل يحتوي على علامات تنصيص أو فواصل أو أسطر جديدة.