Định dạng & kiểm tra YAML

Công cụ này làm gì

YAML được dùng rộng rãi cho tệp cấu hình — manifest Kubernetes, workflow GitHub Actions và GitLab CI, Docker Compose, playbook Ansible, tài liệu OpenAPI — vì dễ đọc. Nhưng nó cũng dễ hỏng: thụt lề sai một khoảng, một ký tự tab, dấu nháy chưa đóng hay thiếu khoảng trắng sau dấu hai chấm đều có thể làm thay đổi ý nghĩa tệp hoặc khiến tệp không tải được.

Công cụ này phân tích YAML của bạn và báo từng lỗi cú pháp kèm dòng và cột, cùng các cảnh báo như chỉ thị không xác định. Khi YAML hợp lệ, công cụ cho biết số tài liệu và kiểu giá trị gốc của từng tài liệu, đồng thời có thể in ra bản định dạng lại gọn gàng với thụt lề thống nhất.

Cách dùng

1. Dán YAML vào ô nhập, tải lên tệp .yaml hoặc .yml, hoặc bấm Mẫu.
2. Kết quả hiện ngay khi bạn gõ: huy hiệu xanh YAML hợp lệ hoặc danh sách lỗi như Dòng 3, cột 2.
3. Giữ Hiện YAML đã định dạng bật để có bản gọn gàng, chọn thụt lề 2 hoặc 4 dấu cách. Sao chép bằng nút phía trên khối.
4. Chỉ tắt Khóa trùng là lỗi khi công cụ của bạn cho phép khóa lặp lại.

Lỗi thường gặp

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

• Thụt lề không nhất quán: các mục cùng cấp phải bắt đầu ở cùng một cột. YAML không cho phép dùng tab để thụt lề.
• Thiếu khoảng trắng sau dấu hai chấm: key:value là một chuỗi thường, không phải khóa và giá trị.
• Ký tự đặc biệt không có dấu nháy: giá trị bắt đầu bằng *, &, !, %, @ hoặc dấu backtick, hay chứa : hoặc #, cần đặt trong dấu nháy.
• Kiểu dữ liệu bất ngờ: yes, no, on và off là chuỗi trong YAML 1.2 nhưng là boolean với trình phân tích YAML 1.1 cũ; hãy đặt trong dấu nháy cho chắc. Số phiên bản như 1.10 sẽ thành số 1.1 nếu không có dấu nháy.

Kiểm tra cấu trúc

Công cụ này kiểm tra cú pháp, tức là văn bản có phải YAML đúng định dạng hay không. Để kiểm tra tệp có đúng khóa và kiểu giá trị, hãy chuyển nó bằng công cụ YAML sang JSON rồi kiểm tra kết quả bằng công cụ Kiểm tra JSON Schema.