مدقّق YAML ومنسّقه

الصق YAML لفحص صياغته وتحديد أخطائه بدقة والحصول على مخرجات نظيفة بتنسيق متّسق.

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

YAMLالمدخلات

فارغ

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 الخروج من ملء الشاشة
حجم النص في المحرّر

وحّد تنسيق YAML الفوضوي

المسافات البادئة المختلطة والتعيينات المضمّنة وعلامات الاقتباس غير الضرورية كلها تُحلَّل بلا مشكلة، لكنها صعبة المراجعة. وتمنح المخرجات المنسّقة كل ملف الشكل نفسه.

المدخلات
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
المنسّق
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

أخطاء YAML الشائعة وكيفية إصلاحها

هذه هي الرسائل التي ستراها أكثر من غيرها، في هذا المدقّق وفي أدوات مثل kubectl وHelm وdocker compose.

رسالة الخطأمعناها وكيفية إصلاحها
tab characters must not be used in indentation لا يسمح YAML إلا بالمسافات في المسافة البادئة. استبدل كل علامة جدولة (tab) بمسافات.
bad indentation of a mapping entry مفتاح مُزاح بشكل مختلف عن المفاتيح المجاورة له، أو قيمة عادية تحتوي على ": ". حاذِ المفتاح مع جيرانه، أو اقتبس القيمة.
mapping values are not allowed in this context المشكلة نفسها كما يبلغ عنها kubectl وHelm: عادةً قيمة غير مقتبسة تحتوي على ": "، مثل URL أو وقت. اقتبس القيمة.
end of the stream or a document separator is expected عنصر قائمة أو مفتاح في مستوى إزاحة خاطئ، مثل قائمة يتبعها تعيين في المستوى نفسه.
unexpected end of the stream within a flow collection قائمة مضمّنة [ … ] أو تعيين مضمّن { … } لم يُغلق. أضف القوس المفقود.
duplicated mapping key المفتاح نفسه يظهر مرتين في تعيين واحد. احذف أحدهما أو أعد تسميته.
unidentified alias اسم بديل مثل *defaults مستخدم قبل مرساته &defaults، أو من دونها.

ما الذي يفحصه المدقّق

اكسر الملف عمدًا باستخدام الأزرار وراقب أي فحص يكتشف الخطأ.

الصياغة والمسافة البادئة

يُبلَّغ عن علامات الجدولة والمفاتيح غير المحاذية وعلامات الاقتباس والأقواس غير المغلقة مع السطر والعمود بدقة.

المفاتيح المكررة

المفتاح المعرَّف مرتين في التعيين نفسه خطأ، بينما تحتفظ بعض المحلّلات بالقيمة الأخيرة بصمت.

المراسي والأسماء البديلة

يجب أن يشير كل اسم بديل إلى مرساة معرّفة قبله في المستند، ويجب أن تشير مفاتيح الدمج إلى تعيينات.

مستندات متعددة

يُحلَّل كل مستند في ملف مفصول بـ ---، وتوضح الملاحظات عدد المستندات التي عُثر عليها.

خاص افتراضيًا

يعمل التحقق داخل متصفحك، لذا لا تغادر الأسرار الموجودة في ملفات CI وملفات manifest جهازك أبدًا.

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

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

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

كيف أتحقق من صحة YAML عبر الإنترنت؟

الصق YAML أو أفلت ملف .yaml أو .yml. تعرض الشارة «YAML صالح» أو «YAML غير صالح» أثناء الكتابة. وللملف غير الصالح تحصل على رسالة الخطأ مع السطر والعمود بدقة، ويُميَّز السطر في المحرّر.

ماذا تفعل المخرجات المنسّقة؟

تعيد كتابة البيانات نفسها بمسافة بادئة وعلامات اقتباس متّسقة: نمط الكتل، والمسافة البادئة التي اخترتها، وعلامات الاقتباس فقط حيث تلزم. إنها طريقة سريعة لتوحيد تنسيق ملف قبل إضافته في commit.

هل تُحفظ التعليقات في المخرجات المنسّقة؟

لا. يحلّل المدقّق YAML إلى بيانات ثم يكتبها من جديد، والتعليقات ليست جزءًا من البيانات. استخدم المخرجات للتحقق من البنية، واحتفظ بملفك الأصلي إذا كانت تعليقاته مهمة.

هل يمكنني التحقق من ملف YAML متعدد المستندات؟

نعم. يُفحص كل مستند من المستندات المفصولة بـ ---، وتحتفظ المخرجات المنسّقة بها كمستندات منفصلة. وتوضح الملاحظات أسفل المحرّر عدد المستندات التي عُثر عليها.

هل يفحص مخططات Kubernetes أو Docker Compose؟

يفحص صياغة YAML، لا مخططًا محددًا. قد يكون الملف YAML صالحًا ومع ذلك يرفضه kubectl أو docker compose بسبب حقل غير معروف. استخدم kubectl apply --dry-run=server أو docker compose config لفحص المخططات.

ما إصدار YAML المستخدم؟

يتبع التحليل مخطط core في YAML 1.2، لذا تبقى yes وno وon وoff سلاسل نصية. ومع تفعيل «آمن لـ YAML 1.1» تقتبس المخرجات هذه الكلمات، فتقرؤها المحلّلات الأقدم مثل PyYAML سلاسل نصية أيضًا.