YAML Validator

Tính năng nổi bật

• Phát hiện ký tự tab trong phần thụt lề — lỗi YAML tuyệt đối cấm nhưng rất dễ gõ nhầm khi copy từ nơi khác
• So sánh độ thụt lề của mỗi dòng với dòng cha để phát hiện mức tăng không đồng nhất giữa các cấp
• Bắt lỗi key:value thiếu dấu cách — trường hợp YAML âm thầm đọc thành chuỗi thay vì cặp khóa-giá trị
• Đếm số dấu nháy đơn và nháy kép trên từng dòng để phát hiện chuỗi bị hở, thiếu dấu đóng
• Dò khóa bị khai báo hai lần trong cùng một mapping ở cùng cấp thụt lề, kèm số dòng khai báo đầu tiên
• Xử lý đúng ngữ cảnh danh sách: mỗi phần tử "- key:" được coi là một object mới, không báo nhầm là khóa lặp với phần tử trước
• Toàn bộ xử lý chạy trong trình duyệt, không upload file lên máy chủ nào
• Nói rõ đây là bộ kiểm tra heuristic, không phải trình phân tích YAML 1.2 đầy đủ, để người dùng không hiểu nhầm mức độ đảm bảo

Vì sao cần một bước kiểm tra riêng trước khi chạy YAML

YAML là định dạng nhạy cảm với khoảng trắng ở mức khó chịu hơn hầu hết ngôn ngữ cấu hình khác, vì bản thân cấu trúc cha-con được biểu diễn hoàn toàn bằng số cột thụt lề chứ không có dấu ngoặc đóng-mở như JSON. Hậu quả là những lỗi nhỏ nhất — một ký tự tab lẫn vào, một dấu cách thiếu sau dấu hai chấm — không làm chương trình báo lỗi cú pháp rõ ràng mà khiến dữ liệu bị đọc sai lặng lẽ. Một pipeline CI/CD dùng GitHub Actions hay một file cấu hình Kubernetes viết sai một cột thụt lề có thể chạy được nhưng áp dụng nhầm cấu hình vào tầng khác, và lỗi kiểu này thường chỉ lộ ra khi hệ thống đã chạy sai trong sản xuất. Công cụ này quét trước những lỗi phổ biến nhất theo kinh nghiệm thực tế của cộng đồng, để bạn bắt được vấn đề ngay lúc soạn thảo thay vì sau khi đã deploy.

Lợi ích khi sử dụng

• •Bắt được lỗi thụt lề và cú pháp trước khi commit, đỡ mất công debug sau khi pipeline đã chạy sai
• •Giải thích bằng tiếng Việt lý do từng lỗi có vấn đề, không chỉ nêu tên quy tắc
• •Không cần cài thư viện hay công cụ dòng lệnh nào để kiểm tra nhanh một đoạn YAML
• •Phát hiện khóa lặp — lỗi mà nhiều trình phân tích chấp nhận âm thầm chứ không báo
• •Dữ liệu chỉ xử lý cục bộ trong trình duyệt, phù hợp để dán cả file cấu hình có thông tin nhạy cảm

Cách dùng YAML Validator

1. 1Dán toàn bộ nội dung file YAML vào khung soạn thảo bên trái, hoặc bấm nút dán ví dụ lỗi mẫu để xem công cụ hoạt động thế nào.
2. 2Kết quả kiểm tra cập nhật ngay lập tức bên phải, mỗi phát hiện hiện số dòng, tên quy tắc vi phạm và lời giải thích cụ thể.
3. 3Sửa từng lỗi theo thứ tự dòng, ưu tiên lỗi tab và khóa lặp trước vì hai loại này gây sai lệch cấu trúc nghiêm trọng nhất.
4. 4Sau khi khung kết quả báo không phát hiện lỗi, vẫn nên nạp thử file bằng đúng thư viện YAML mà dự án bạn dùng (PyYAML, js-yaml, snakeyaml...) trước khi triển khai thật.
5. 5Với file YAML dùng anchor, alias hay tag đặc biệt, công cụ này không phân tích các cấu trúc đó — hãy dựa vào trình phân tích chính thức cho phần này.

Vì sao YAML cấm dùng tab để thụt lề

Đặc tả YAML quy định rõ phần thụt lề chỉ được dùng dấu cách, không được dùng ký tự tab. Lý do không phải vì tab "xấu" mà vì độ rộng hiển thị của một ký tự tab không cố định — trình soạn thảo này hiển thị tab rộng bốn cột, trình khác hiển thị rộng tám cột, còn một số công cụ dòng lệnh lại hiển thị tab như một cột duy nhất. Nếu YAML cho phép trộn tab với dấu cách trong thụt lề, hai dòng nhìn thẳng hàng trên màn hình của bạn có thể được trình phân tích hiểu là hai cấp thụt lề khác nhau tùy theo cách nó quy đổi độ rộng tab, dẫn tới việc cùng một file cho ra cấu trúc dữ liệu khác nhau trên hai máy khác nhau. Vì rủi ro đó, những trình phân tích YAML tuân thủ đặc tả — bao gồm PyYAML, js-yaml, hầu hết công cụ CI/CD — đều từ chối thẳng file có tab trong phần thụt lề bằng một lỗi cú pháp. Lỗi này rất hay gặp khi bạn copy đoạn cấu hình từ một trang web, một tin nhắn Slack, hoặc một file cũ được soạn bằng trình soạn thảo mặc định chèn tab, vì ký tự tab thường không hiện rõ trên màn hình như dấu cách.

Thụt lề không nhất quán gây sai cấu trúc cha con như thế nào

Trong YAML, số cột thụt lề chính là cách duy nhất để biểu diễn quan hệ cha con giữa các phần tử. Một dòng thụt sâu hơn dòng phía trên nó luôn được hiểu là con của dòng đó, bất kể mức tăng là một, hai hay năm cột — YAML không bắt buộc một con số cố định như hai hoặc bốn cột cho mỗi cấp, nhưng để tài liệu nhất quán và dễ đọc, hầu hết đội ngũ đều thống nhất một mức tăng cố định trong toàn bộ file. Vấn đề nảy sinh khi một phần của tài liệu tăng hai cột cho mỗi cấp còn phần khác lại tăng ba hoặc bốn cột — không phải lúc nào YAML cũng báo lỗi cú pháp cho việc này, vì về mặt kỹ thuật một cấp thụt sâu hơn vẫn hợp lệ dù tăng bao nhiêu cột. Cái nguy hiểm là sự nhầm lẫn của người đọc và người viết: một dòng được lập trình viên định để là con của một khóa nhưng lại vô tình thụt sai số cột khiến trình phân tích xếp nó vào làm anh em với khóa cha thay vì con của khóa cha, âm thầm đổi hẳn cấu trúc dữ liệu mà không có thông báo lỗi nào xuất hiện.

Vì sao thiếu dấu cách sau dấu hai chấm lại nguy hiểm hơn vẻ ngoài

Trong cú pháp mapping của YAML, dấu hai chấm chỉ được hiểu là dấu phân tách khóa-giá trị khi có dấu cách hoặc dấu xuống dòng ngay sau nó. Viết "port:8080" không có dấu cách khiến trình phân tích không nhận ra đây là một cặp khóa-giá trị mà đọc toàn bộ chuỗi "port:8080" như một giá trị scalar duy nhất — nếu dòng này nằm độc lập không thuộc ngữ cảnh mapping nào khác, kết quả có thể là lỗi cú pháp, nhưng nếu nó nằm trong một danh sách các chuỗi thì YAML chấp nhận hoàn toàn hợp lệ và bạn nhận về một chuỗi văn bản kỳ lạ thay vì con số cổng bạn định khai báo. Đây là loại lỗi khó phát hiện bằng mắt nhất trong toàn bộ danh sách quy tắc, vì hình ảnh hiển thị trên màn hình gần như giống hệt với dòng đúng "port: 8080", chỉ khác đúng một dấu cách. Rất nhiều lỗi cấu hình Docker Compose và Kubernetes từng bắt nguồn từ chính lỗi đánh máy nhỏ này.

Dấu nháy hở cặp lan lỗi sang các dòng phía sau

Khi một chuỗi trong YAML được mở đầu bằng dấu nháy kép hoặc nháy đơn nhưng thiếu dấu đóng tương ứng trên cùng dòng, trình phân tích không tự động coi dòng đó kết thúc chuỗi ở cuối dòng như với chuỗi không có nháy. Thay vào đó, nó tiếp tục tìm dấu đóng ở những dòng tiếp theo, gộp toàn bộ nội dung các dòng đó — bao gồm cả những khóa và cấu trúc khác vốn không liên quan — vào làm một chuỗi văn bản duy nhất cho tới khi gặp được dấu nháy đóng ở đâu đó xa hơn trong file, hoặc báo lỗi cú pháp nếu không tìm thấy dấu đóng nào cho tới hết file. Hậu quả thường thấy là một lỗi cú pháp xuất hiện ở một dòng cách xa vị trí gõ sai hàng chục dòng, khiến người sửa lỗi tưởng nhầm vấn đề nằm ở chỗ báo lỗi thay vì chỗ thiếu dấu nháy thực sự. Công cụ này kiểm tra số lượng dấu nháy trên từng dòng riêng lẻ để bắt sớm chính xác dòng gây ra vấn đề.

Khóa lặp: lỗi mà YAML không báo nhưng vẫn âm thầm phá dữ liệu

Theo đặc tả YAML 1.2, khai báo hai khóa giống hệt nhau trong cùng một mapping là hành vi không hợp lệ. Tuy nhiên phần lớn trình phân tích được triển khai trong thực tế — bao gồm cả những thư viện phổ biến nhất — không coi đây là lỗi cú pháp cứng mà chỉ đơn giản lấy giá trị của lần khai báo sau cùng, ghi đè lặng lẽ lên giá trị khai báo trước đó. Đây là kiểu lỗi đặc biệt nguy hiểm trong file cấu hình lớn, vì trong một file dài hàng trăm dòng, việc cùng một khóa như "timeout" hay "replicas" xuất hiện hai lần ở hai vị trí cách xa nhau — có thể do một người thêm vào sau mà không biết khóa đã tồn tại, hoặc do copy-paste một khối cấu hình rồi quên xóa dòng cũ — rất khó phát hiện bằng mắt thường khi đọc lướt. Hệ quả thực tế là bạn tưởng mình đã đặt timeout là ba mươi giây ở dòng đầu, nhưng giá trị thực sự được áp dụng lại là giá trị năm giây bị khai báo lại ở một dòng khác phía dưới mà không có cảnh báo nào cho biết điều đó.

Câu hỏi thường gặp (FAQ)

Từ khóa liên quan

• kiểm tra cú pháp yaml online
• yaml validator tiếng việt
• lỗi thụt lề yaml
• yaml không được dùng tab
• kiểm tra file yaml
• yaml key value thiếu dấu cách
• duplicate key yaml
• yaml lint online
• kiểm tra docker compose yaml
• kiểm tra kubernetes yaml
• yaml github actions lỗi cú pháp
• yaml indentation error
• dấu nháy không khớp trong yaml
• yaml parser lỗi dòng nào
• sửa lỗi yaml online
• yaml mapping trùng khóa
• công cụ kiểm tra yaml miễn phí
• yaml syntax checker
• yaml 1.2 quy tắc thụt lề
• kiểm tra file cấu hình yaml không cần cài đặt