ما هو محوّل JSON إلى YAML؟

يحوِّل محوِّل JSON إلى YAML بيانات JSON إلى صيغة YAML نظيفة، وهي أكثر قابلية للقراءة البشرية وتُستخدم عادةً في ملفات التهيئة (Docker Compose وKubernetes وخطوط CI/CD). يتعامل مع الكائنات المتداخلة والمصفوفات والسلاسل متعددة الأسطر بصياغة YAML صحيحة.

يستخدم المحوّل مكتبة js-yaml خلف الكواليس، ويتعامل مع النصوص متعددة الأسطر والمراسي ومصفوفات الكائنات دون فقدان البنية. عرض المسافة 2 أو 4 (معظم ملفات الإعداد تستخدم 2). أسلوب التدفّق يُبقي المصفوفات القصيرة على سطر واحد ([a, b, c])، بينما يكتب أسلوب الكتلة عنصراً في كل سطر. هناك خيار «ترتيب المفاتيح» لإخراج ثابت في أنظمة التحكم بالنسخ.

كيفية الاستخدام

1. الخطوة 1 — الصق بيانات JSON أو قم بتحميل ملف .json. يتم اكتشاف JSON غير الصالح وإبرازه قبل التحويل.
2. الخطوة 2 — حدِّد عرض المسافة البادئة (2 أو 4 مسافات) واختر خيارات أسلوب التدفق للمصفوفات المدمجة أو الكائنات المضمَّنة.
3. الخطوة 3 — اعرض مخرج YAML مع تمييز الصياغة، ثم انسخه أو نزِّله كملف .yaml للاستخدام في ملفات التهيئة الخاصة بك.

متى تستخدم

• ترجمة جزء من package.json أو tsconfig.json إلى صيغة YAML التي تنتظرها أداة CI.
• كتابة بيانات Kubernetes أو ملفات Docker Compose انطلاقاً من ردود API أو JSON مُولَّد.
• تحويل إعدادات JSON من أداة قديمة إلى ملف YAML أكثر وضوحاً لأداة محدَّثة.

النتيجة

تقوم بتحويل package.json إلى تهيئة YAML لخط أنابيب CI. الصق JSON، واضبط المسافة البادئة على مسافتين، واحصل على مخرج YAML نظيف تكون فيه الاعتماديات المتداخلة مرئية بوضوح دون أقواس معقوصة أو علامات اقتباس.

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

هل YAML مجرد JSON بصياغة مختلفة؟

غالباً نعم. YAML 1.2 يشمل JSON بالكامل، فأي JSON صحيح هو YAML صحيح. تضيف YAML التعليقات والنصوص متعددة الأسطر والمراسي والأسماء المستعارة وتخطيطاً قائماً على المسافات. للبيانات الخام، الصيغتان متبادلتان.

هل أستعمل مسافتين أم أربعاً للمسافة البادئة؟

العرف في Kubernetes و Docker Compose و GitHub Actions ومعظم أدوات CI هو مسافتان. أربع مسافات أوضح في الملفات شديدة التداخل لكنها غير شائعة. وافق الإعدادات السائدة لدى فريقك حتى تبقى فروقات diff نظيفة.

متى أنتقل إلى أسلوب التدفّق؟

أسلوب التدفّق ({a: 1, b: 2}) مناسب للمصفوفات القصيرة من القيم البدائية، مثل قائمة منافذ، إذ يبدو أسلوب الكتلة فيها مزدحماً. أبقِ أسلوب الكتلة لكل ما يحتاج إلى قراءة أو تحرير يدوي.

ماذا يحدث للنصوص التي تشبه القيم المنطقية أو الأرقام؟

تحويل أنواع YAML قد يكون عدوانياً: 'yes' و'no' و'on' و'1.0' و'null' يُعاد تفسيرها. يحيط المحوّل هذه السلاسل بعلامات اقتباس لتبقى نصوصاً، ما يتجنّب خطأ «النرويج» الشهير حيث يصبح الرمز NO قيمة false.

هل يمكنني التحويل ذهاباً وإياباً بين JSON و YAML بلا فقد؟

للبيانات البحتة: نعم، تُحفَظ البنية. ما يضيع هو التعليقات (لا توجد في JSON) وأحياناً ترتيب المفاتيح، إذ قد يعيد محلل JSON ترتيبه. لتثبيت الترتيب فعّل خيار «ترتيب المفاتيح» في الطرفين.

أدوات ذات صلة