ตัวอย่างข้อผิดพลาดในการเยื้อง YAML: ทีละช่อง

หน้านี้เปิดตัวตรวจสอบ YAML ที่โหลดไว้ล่วงหน้าด้วยการกำหนดค่าเซิร์ฟเวอร์แบบสั้นซึ่งมีข้อผิดพลาดทั่วไปที่เกิดขึ้นจริง: หลังจากที่คีย์สองคีย์ซ้อนกันสี่ช่องว่างลึก คีย์ต่อไปนี้จะกลับไปเหลือสามช่องว่างแทนที่จะกลับไปยังระดับช่องว่างสองช่องของบล็อกที่ปิดล้อม YAML ไม่มีความทนทานต่อแท็บเทียบกับช่องว่าง และไม่มีความกว้างเยื้องคงที่ ดังนั้นพื้นที่จรจัดเดี่ยวเช่นนี้จึงไม่เฉลี่ยออกมา - เพียงแต่ไม่ตรงกับบล็อกที่เปิดอยู่ และไฟล์ไม่ถูกต้อง การตรวจสอบที่ล้มเหลวด้านล่างจะทำงานทันทีที่โหลดหน้าเว็บ

นี่เป็นวิธีหนึ่งที่พบบ่อยที่สุดในทางปฏิบัติ YAML จริงจะพัง: การแก้ไขไฟล์ด้วยมือในโปรแกรมแก้ไขที่ไม่บังคับใช้ขนาดการเยื้องที่สอดคล้องกัน หรือการวางส่วนย่อยจากที่ไหนสักแห่งที่มีระยะห่างแตกต่างจากบล็อกโดยรอบ ซึ่งแตกต่างจากคีย์ที่ซ้ำกันหรือแท็บที่หลงทาง การเยื้องทีละรายการนั้นง่ายต่อการมองข้าม โดยเฉพาะอย่างยิ่งในไฟล์ Manifest ของ Kubernetes ที่ซ้อนกันลึกหรือไฟล์ไปป์ไลน์ CI ซึ่งเป็นเหตุผลว่าทำไมการตรวจสอบอัตโนมัติจึงจับได้เร็วกว่าผู้ตรวจสอบที่เป็นมนุษย์จะสแกนส่วนต่าง

แทนที่ข้อความตัวอย่างด้วยไฟล์ของคุณเองเพื่อดูการรายงานบรรทัดและคอลัมน์เดียวกันกับการกำหนดค่าของคุณ เมื่อคุณเข้าใจรูปแบบความล้มเหลวที่นี่แล้ว ให้เปรียบเทียบกับค่าที่กำหนดล่วงหน้า yaml-config-example เพื่อดูโครงสร้างเดียวกันโดยมีการเยื้องที่สอดคล้องกันผ่านอย่างหมดจด