จัดรูปแบบและตรวจสอบ YAML

เครื่องมือนี้ทำอะไร

YAML อ่านง่ายจึงนิยมใช้กับไฟล์ตั้งค่า เช่น manifest ของ Kubernetes, workflow ของ GitHub Actions และ GitLab CI, Docker Compose, playbook ของ Ansible และเอกสาร OpenAPI แต่ก็พังง่ายเช่นกัน เยื้องผิดไปหนึ่งช่อง ใช้แท็บ ลืมปิดเครื่องหมายคำพูด หรือไม่มีช่องว่างหลังโคลอน ล้วนเปลี่ยนความหมายของไฟล์หรือทำให้โหลดไม่ได้

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

วิธีใช้

1. วาง YAML ลงในช่องป้อนข้อมูล อัปโหลดไฟล์ .yaml หรือ .yml หรือกด ตัวอย่าง
2. ผลลัพธ์แสดงขณะพิมพ์: ป้ายสีเขียว YAML ถูกต้อง หรือรายการข้อผิดพลาด เช่น บรรทัด 3 คอลัมน์ 2
3. เปิด แสดง YAML ที่จัดรูปแบบแล้ว ไว้เพื่อรับสำเนาที่เรียบร้อย และเลือกเยื้อง 2 หรือ 4 ช่องว่าง คัดลอกด้วยปุ่มเหนือบล็อก
4. ปิด ถือว่าคีย์ซ้ำเป็นข้อผิดพลาด เฉพาะเมื่อเครื่องมือของคุณอนุญาตให้คีย์ซ้ำได้

ข้อผิดพลาดที่พบบ่อย

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• การเยื้องไม่สม่ำเสมอ: รายการในระดับเดียวกันต้องเริ่มที่คอลัมน์เดียวกัน YAML ไม่อนุญาตให้ใช้แท็บในการเยื้อง
• ไม่มีช่องว่างหลังโคลอน: key:value เป็นสตริงธรรมดา ไม่ใช่คีย์และค่า
• อักขระพิเศษไม่มีเครื่องหมายคำพูด: ค่าที่ขึ้นต้นด้วย *, &, !, %, @ หรือ backtick หรือมี : หรือ # ต้องใส่เครื่องหมายคำพูด
• ชนิดข้อมูลที่ไม่คาดคิด: yes, no, on และ off เป็นสตริงใน YAML 1.2 แต่เป็นบูลีนในตัวแยกวิเคราะห์ YAML 1.1 รุ่นเก่า ใส่เครื่องหมายคำพูดไว้เพื่อความปลอดภัย หมายเลขเวอร์ชันอย่าง 1.10 จะกลายเป็นตัวเลข 1.1 หากไม่ใส่เครื่องหมายคำพูด

ตรวจสอบโครงสร้าง

เครื่องมือนี้ตรวจไวยากรณ์ คือดูว่าข้อความเป็น YAML ที่ถูกรูปแบบหรือไม่ หากต้องการตรวจว่าไฟล์มีคีย์และชนิดค่าที่ถูกต้อง ให้แปลงด้วยเครื่องมือ YAML เป็น JSON แล้วตรวจผลลัพธ์ด้วยเครื่องมือตรวจสอบ JSON Schema