مثال على خطأ المسافة البادئة YAML: مسافة Off-by-One

تفتح هذه الصفحة مدقق YAML الذي تم تحميله مسبقًا بتكوين خادم قصير يحتوي على خطأ شائع حقيقي: بعد تداخل مفتاحين بعمق أربع مسافات، يعود المفتاح التالي إلى ثلاث مسافات بدلاً من العودة إلى مستوى المسافتين للكتلة المرفقة. لا يحتوي YAML على تسامح مع علامات التبويب مقابل المسافات ولا يوجد عرض مسافة بادئة ثابتة، لذا فإن مسافة واحدة ضالة مثل هذه لا يتم حساب متوسطها - إنها ببساطة لا تتطابق مع أي كتلة مفتوحة، والملف غير صالح. يتم تشغيل عملية التحقق الفاشلة أدناه مباشرة لحظة تحميل الصفحة.

هذه هي إحدى الطرق الأكثر شيوعًا لكسر YAML في الممارسة العملية: التحرير اليدوي للملف في محرر لا يفرض حجم مسافة بادئة ثابتة، أو لصق جزء من مكان ما بمسافات مختلفة عن الكتلة المحيطة. على عكس المفتاح المكرر أو علامة التبويب الضالة، من السهل تفويت زلة المسافة البادئة بالعين المجردة، خاصة في بيان Kubernetes المتداخل بشدة أو ملف خط أنابيب CI - وهذا هو بالضبط السبب وراء اكتشاف الفحص الآلي لها بشكل أسرع من قيام المراجع البشري بمسح الفرق.

استبدل نموذج النص بملفك الخاص لترى نفس تقارير السطر والعمود المطبقة على التكوين الخاص بك. بمجرد فهم نمط الفشل هنا، قارنه مع الإعداد المسبق yaml-config-example لرؤية نفس البنية مع مسافة بادئة متسقة تمر بشكل نظيف.