YAML có phải là tập cha của JSON không?

YAML 1.2 về mặt kỹ thuật là tập cha của JSON — bất kỳ tài liệu JSON hợp lệ nào cũng là YAML 1.2 hợp lệ. Tuy nhiên, YAML 1.1 (vẫn được dùng bởi nhiều parser) có các quy tắc diễn giải boolean khác và có thể không phân tích tất cả JSON hợp lệ một cách đúng đắn. Trong thực tế, đối xử với chúng như tương thích chứ không phải hoán đổi: dùng một parser YAML cho các tệp YAML và một parser JSON cho các tệp JSON thay vì giả định một cái xử lý cái kia.

YAML có thể có bình luận không? JSON có thể không?

YAML hỗ trợ bình luận dùng ký tự #, đây là một trong những lợi thế được trích dẫn nhiều nhất so với JSON. JSON cố ý bỏ qua bình luận — đặc tả không định nghĩa cú pháp bình luận. JSON5 (một phần mở rộng không chính thức) và JSONC (JSON với Bình luận, được dùng bởi VS Code) thêm hỗ trợ bình luận, nhưng chúng không phải là JSON hợp lệ và yêu cầu các parser không chuẩn. Nếu trường hợp sử dụng của bạn yêu cầu cấu hình dễ đọc cho người với ghi chú giải thích, YAML phù hợp hơn.

Cái nào nhanh hơn để phân tích: JSON hay YAML?

JSON nhanh hơn đáng kể để phân tích. Các parser JSON đơn giản và được tối ưu hóa tốt — các triển khai hiện đại trong V8, CPython và JVM phân tích JSON ở hàng trăm megabyte mỗi giây. Các parser YAML phải xử lý thụt dòng, anchor, alias, nhiều kiểu scalar và các trường hợp biên phức tạp, làm cho chúng chậm hơn đáng kể. Đối với các phản hồi API thông lượng cao hoặc các tệp dữ liệu lớn, JSON là người chiến thắng rõ ràng về hiệu năng.

Tại sao Kubernetes và GitHub Actions dùng YAML thay vì JSON?

Các công cụ này được cấu hình bởi con người viết tệp bằng tay, không phải được tạo bởi máy. Hỗ trợ bình luận, chuỗi đa dòng và cú pháp danh sách/ánh xạ sạch sẽ hơn của YAML làm cho các tệp cấu hình dễ đọc và bảo trì hơn. Các workflow GitHub Actions thường bao gồm các bình luận giải thích và logic đa bước sẽ không thuận tiện trong JSON. Các manifest Kubernetes mô tả trạng thái hệ thống dự định mà các đội ngũ xem xét trong các đánh giá code — khả năng đọc quan trọng hơn tốc độ phân tích.

Vấn đề Na Uy trong YAML là gì?

Trong YAML 1.1, chuỗi hai ký tự 'NO' được diễn giải là boolean false vì YAML 1.1 đối xử 'no', 'n', 'false', 'off' và các biến thể viết hoa của chúng như false. Điều này có nghĩa là một ánh xạ YAML với một khóa mã quốc gia 'NO' cho Na Uy sẽ phân tích giá trị không đúng nếu nó xuất hiện trong ngữ cảnh boolean. Tương tự 'YES' sẽ là true và 'ON' cũng sẽ là true. YAML 1.2 khắc phục điều này bằng cách chỉ nhận diện 'true' và 'false' là boolean, nhưng nhiều parser vẫn triển khai hành vi 1.1.

Khi nào tôi nên chuyển đổi giữa JSON và YAML?

Chuyển JSON sang YAML khi bạn muốn làm cho cấu hình được tạo bởi máy dễ đọc cho người hơn, thêm bình luận, hoặc đưa dữ liệu vào một công cụ nguyên bản YAML như Kubernetes hoặc Ansible. Chuyển YAML sang JSON khi bạn cần gửi dữ liệu đến một API, xử lý nó với một công cụ JSON, hoặc lưu trữ nó trong cơ sở dữ liệu. Cả hai bộ chuyển đổi JSON to YAML và YAML to JSON của Toova xử lý chuyển đổi trong trình duyệt mà không gửi dữ liệu của bạn đến máy chủ.

JSON vs YAML — Khi Nào Dùng Cái Nào

10 tháng 5, 2026 Toova

JSON và YAML đều là các cách để biểu diễn dữ liệu có cấu trúc dưới dạng văn bản. Cả hai đều hỗ trợ chuỗi, số, boolean, mảng và các object lồng nhau. Cả hai đều được hỗ trợ rộng rãi qua mọi ngôn ngữ lập trình và nền tảng. Tuy nhiên, chúng đánh đổi rất khác nhau: JSON tối ưu cho khả năng đọc của máy và tốc độ phân tích; YAML tối ưu cho khả năng đọc của người và cấu hình biểu cảm. Biết khi nào tiếp cận cái nào ngăn ngừa loại ma sát đến từ việc sử dụng định dạng cấu hình được thiết kế cho API để viết các tệp cấu hình được viết bằng tay, hoặc ngược lại.

Hướng dẫn này bao quát các khác biệt cú pháp, các điểm mạnh và yếu thực tế của mỗi định dạng, các lựa chọn công cụ thực tế phụ thuộc vào định dạng, các cân nhắc hiệu năng và một khuôn khổ quyết định rõ ràng cho năm 2026.

JSON: Tổng Quan

JSON (JavaScript Object Notation) được Douglas Crockford chính thức hóa vào đầu những năm 2000 và được chuẩn hóa trong RFC 8259 và ECMA-404. Mục tiêu thiết kế của nó là một định dạng tối thiểu, không mơ hồ có thể được phân tích và tuần tự hóa bởi bất kỳ ngôn ngữ lập trình nào mà không yêu cầu một parser phức tạp.

JSON hỗ trợ chính xác sáu loại dữ liệu: chuỗi (luôn được đặt trong dấu nháy kép), số, boolean (true/false), null, object (các ánh xạ key-value với các khóa chuỗi) và mảng (các danh sách có thứ tự). Không có bình luận, không có kiểu ngày, không có kiểu nhị phân, không có tham chiếu. Sự tối thiểu này là cố ý: các quy tắc nghiêm ngặt loại bỏ sự mơ hồ và làm cho các parser đơn giản và nhanh.

{
  "name": "deploy-service",
  "version": "2.1.0",
  "environment": "production",
  "replicas": 3,
  "enabled": true,
  "tags": ["backend", "critical"],
  "resources": {
    "cpu": "500m",
    "memory": "512Mi"
  }
}

Mỗi khóa phải được đặt trong dấu nháy kép. Dấu phẩy thừa không được phép. Không có cách nào để viết bình luận. Các chuỗi không thể trải qua nhiều dòng mà không escape ký tự xuống dòng. Các ràng buộc này làm cho JSON khó viết bằng tay nhưng dễ dàng tạo từ code và phân tích ở đầu nhận.

YAML: Tổng Quan

YAML (YAML Ain't Markup Language) được thiết kế bởi Clark Evans, Ingy dot Net và Oren Ben-Kiki bắt đầu năm 2001. Phiên bản 1.2, đạt được khả năng tương thích JSON, đã được hoàn thiện năm 2009. Mục tiêu thiết kế của YAML là một định dạng dữ liệu dễ đọc cho người mà các nhà phát triển có thể viết trực tiếp trong các trình soạn thảo văn bản mà không cần học cú pháp mới. Đặc tả đầy đủ tại yaml.org.

YAML dùng thụt dòng để biểu thị cấu trúc thay vì dấu ngoặc. Các danh sách dùng dấu gạch ngang. Các khóa không được đặt trong dấu nháy theo mặc định. Các bình luận bắt đầu bằng #. Các chuỗi không yêu cầu dấu nháy trừ khi chúng chứa các ký tự đặc biệt. Các chuỗi đa dòng có cú pháp khối scalar chuyên dụng.

# Cấu hình triển khai cho production
name: deploy-service
version: 2.1.0
environment: production
replicas: 3
enabled: true

tags:
  - backend
  - critical

resources:
  cpu: 500m
  memory: 512Mi

Cùng cấu trúc dữ liệu được biểu đạt trong YAML ngắn hơn đáng kể và dễ đọc hơn — đặc biệt khi nó bao gồm các bình luận hoặc các danh sách lồng nhau. Sự đánh đổi là parser YAML phải xử lý độ phức tạp nhiều hơn đáng kể: nhạy cảm thụt dòng, nhiều cách để biểu đạt cùng kiểu, anchor, alias, các khóa gộp và một di sản lịch sử của diễn giải boolean mơ hồ.

So Sánh Cú Pháp Cạnh Nhau

Chuỗi đa dòng

Các chuỗi đa dòng là một trong các lợi thế rõ ràng nhất của YAML cho các tệp cấu hình. YAML cung cấp hai kiểu khối scalar: literal (|) bảo toàn xuống dòng chính xác, và folded (>) nối các dòng với khoảng trắng cho văn xuôi dài.

# YAML: nhiều cách viết các chuỗi đa dòng
# Khối literal (bảo toàn xuống dòng)
description: |
  Đây là dòng một.
  Đây là dòng hai.
  Dòng cuối với xuống dòng kết thúc.

# Khối folded (xuống dòng trở thành khoảng trắng, tốt cho văn xuôi dài)
summary: >
  Đoạn dài này được viết qua
  nhiều dòng nhưng sẽ được nối thành
  một chuỗi được phân tách bằng khoảng trắng duy nhất.

# Trong JSON, bạn phải escape các xuống dòng
# "description": "Đây là dòng một.
Đây là dòng hai.
Dòng cuối."

Anchor và alias

Các anchor YAML (&) và các alias (*) cho bạn định nghĩa một giá trị một lần và tham chiếu nó ở nhiều nơi, tương tự như một biến. Khóa gộp (<<) gộp nội dung của một ánh xạ vào một cái khác, cung cấp một dạng kế thừa.

# Anchor và alias YAML giảm trùng lặp
defaults: &defaults
  timeout: 30
  retries: 3
  log_level: info

development:
  <<: *defaults   # gộp defaults
  log_level: debug

staging:
  <<: *defaults
  timeout: 60

production:
  <<: *defaults

JSON không có tương đương. Trong JSON, cấu hình lặp lại phải được nhân đôi, được xử lý bởi một lớp templating, hoặc được quản lý bởi logic của ứng dụng tiêu thụ. Các anchor YAML mạnh mẽ cho các cấu hình được duy trì bởi người nhưng có thể làm cho các tệp khó hiểu hơn đối với các người đọc không quen với quy ước.

Điểm Mạnh Và Điểm Yếu

Điểm mạnh JSON

Phân tích không mơ hồ — ngữ pháp đủ đơn giản để nêu trong một trang đơn. Mọi parser tạo cùng kết quả cho một đầu vào.
Tốc độ — các parser JSON là một trong những parser văn bản nhanh nhất tồn tại. V8 phân tích JSON nhanh hơn đáng kể so với chính JavaScript thực thi.
Hỗ trợ JavaScript nguyên bản — JSON.parse() và JSON.stringify() được tích hợp vào mọi runtime JavaScript. Không cần dependency.
Công cụ phổ quát — mọi client API, cơ sở dữ liệu và pipeline dữ liệu đều nói JSON nguyên bản. Đây là định dạng API thực tế.
Không nhạy cảm thụt dòng — khoảng trắng không liên quan đến ý nghĩa, làm cho JSON mạnh mẽ chống lại các khác biệt định dạng giữa các trình soạn thảo, hệ điều hành và công cụ.

Điểm yếu JSON

Không có bình luận — bạn không thể giải thích một giá trị cấu hình inline. Đây là một điểm đau đáng kể cho các tệp được viết bằng tay.
Dài dòng cho người — mọi khóa phải được đặt trong dấu nháy, dấu phẩy phân tách mọi mục, và dấu ngoặc bao quanh mọi object và mảng.
Lỗi dấu phẩy thừa — dấu phẩy thừa sau phần tử mảng hoặc object cuối cùng không hợp lệ và gây ra lỗi phân tích dễ giới thiệu khi chỉnh sửa bằng tay.
Không có chuỗi đa dòng — biểu diễn một chuỗi với các xuống dòng nhúng yêu cầu escape \n, làm cho những thứ như các truy vấn SQL hoặc các script shell đau đớn để nhúng.
Không có kiểu ngày — các ngày là các chuỗi. Các quy ước khác nhau (ISO 8601, dấu thời gian Unix, các định dạng tùy chỉnh) và phải được xử lý bởi ứng dụng.

Điểm mạnh YAML

Bình luận — cú pháp bình luận # làm cho YAML lựa chọn rõ ràng cho các tệp cấu hình cần tài liệu hóa inline.
Khả năng đọc — ít nhiễu cú pháp hơn. Các khóa không được đặt trong dấu nháy, không có dấu phẩy, cấu trúc dựa trên thụt dòng phản ánh cách con người viết các phác thảo.
Các chuỗi đa dòng — các khối scalar literal và folded xử lý các chuỗi dài một cách nhẹ nhàng mà không escape.
Các anchor và các khóa gộp — giảm trùng lặp trong các tệp cấu hình lớn.
Hệ thống kiểu phong phú — các parser YAML suy luận các kiểu từ định dạng giá trị (chuỗi, số nguyên, số float, boolean, null, dấu thời gian) mà không cần chú thích kiểu rõ ràng.

Điểm yếu YAML

Độ phức tạp — đặc tả YAML đầy đủ rất lớn. Các trường hợp biên rất nhiều: vấn đề Na Uy, các bất ngờ ép kiểu ngầm, nhạy cảm tab-vs-khoảng trắng.
Phân tích chậm — các parser YAML chậm hơn đáng kể so với các parser JSON do độ phức tạp của ngữ pháp.
Lỗi thụt dòng — một dòng bị căn lệch duy nhất thay đổi ý nghĩa của tài liệu mà không tạo lỗi phân tích, tạo ra các lỗi tinh tế khó phát hiện.
Vấn đề Na Uy — trong YAML 1.1, NO trần phân tích thành boolean false. Các mã quốc gia, các từ viết tắt và nhiều từ tiếng Anh có các diễn giải boolean không mong đợi trong các parser YAML 1.1 (vẫn phổ biến).
Hành vi parser không nhất quán — các parser YAML của các ngôn ngữ khác nhau triển khai các tập con khác nhau của đặc tả hoặc các phiên bản khác nhau, dẫn đến các vấn đề về tính di động.

Khi Nào Dùng JSON

Các phản hồi và yêu cầu API

JSON là định dạng phổ quát cho các REST API. Mọi thư viện client HTTP có thể tuần tự hóa và giải tuần tự hóa nó nguyên bản. Tốc độ phân tích quan trọng ở quy mô API, và ngữ pháp không mơ hồ của JSON có nghĩa là mọi client và máy chủ phân tích cùng dữ liệu giống hệt nhau. Các phản hồi GraphQL là JSON. Các định nghĩa OpenAPI/Swagger là JSON (mặc dù YAML cũng được chấp nhận). Nếu bạn đang thiết kế một API, mặc định là JSON.

{
  "user": {
    "id": 42,
    "email": "alice@example.com",
    "roles": ["admin", "editor"],
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

Cấu hình được tạo bởi code

Khi một chương trình tạo cấu hình — một công cụ build xuất các tệp lockfile dependency, một framework tạo một manifest dự án, một công cụ triển khai ghi các tổng kiểm tra — JSON là định dạng đúng. Đầu ra không bao giờ cần được viết bằng tay, không cần bình luận, và ngữ pháp không mơ hồ của JSON đảm bảo code tiêu thụ phân tích chính xác cái đã được tạo. package.json, tsconfig.json, package-lock.json và composer.json đều là ví dụ của mẫu này.

Trao đổi dữ liệu giữa các dịch vụ

Khi hai dịch vụ cần trao đổi dữ liệu — các hàng đợi tin nhắn, webhook, các luồng sự kiện — tốc độ, tính phổ quát và tính không mơ hồ của JSON làm cho nó là lựa chọn đúng. Các lợi ích của YAML (bình luận, các chuỗi đa dòng) không liên quan trong các pipeline dữ liệu tự động. Dùng JSON Formatter để kiểm tra các payload trong quá trình gỡ lỗi, và bộ chuyển đổi JSON to YAML nếu bạn cần làm cho một payload dễ đọc cho người vì mục đích tài liệu hóa.

Lưu trữ trong cơ sở dữ liệu

PostgreSQL, MongoDB, MySQL và hầu hết các cơ sở dữ liệu lưu trữ dữ liệu có cấu trúc làm như vậy trong JSON hoặc các định dạng tương thích JSON. YAML không phải là định dạng lưu trữ được hỗ trợ trong bất kỳ cơ sở dữ liệu chính nào. Nếu bạn đang lưu trữ cấu hình hoặc dữ liệu có cấu trúc trong cơ sở dữ liệu, dùng JSON.

Khi Nào Dùng YAML

Cấu hình hạ tầng và triển khai

Các manifest Kubernetes, các biểu đồ Helm, các tệp Docker Compose và các playbook Ansible đều dùng YAML. Các tệp này được viết và xem xét bởi con người, thường chứa các bình luận giải thích, và hưởng lợi từ cú pháp danh sách dễ đọc của YAML để mô tả các bộ tài nguyên. Một Kubernetes Deployment với nhiều container, các volume mount và các biến môi trường dễ đọc hơn đáng kể trong YAML so với JSON.

Các định nghĩa pipeline CI/CD

GitHub Actions, GitLab CI, CircleCI và Bitbucket Pipelines đều dùng YAML cho các định nghĩa pipeline. Các cấu hình pipeline được viết bởi người, thường được bình luận, và chứa logic đa bước hưởng lợi từ cú pháp dễ đọc của YAML.

# Workflow GitHub Actions — phù hợp tự nhiên với YAML
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Chạy test
        run: npm test

Các tệp cấu hình ứng dụng

Các thiết lập Django (qua django-configurations), Ruby on Rails database.yml, cấu hình Gatsby, và nhiều framework khác dùng YAML cho cấu hình của chúng. Khi các nhà phát triển cần đọc và hiểu một tệp cấu hình bên cạnh code, khả năng của YAML để bao gồm các bình luận và các giải thích đa dòng giảm chi phí nhận thức.

Dữ liệu tài liệu hóa

Các trình tạo trang tĩnh như Jekyll, Hugo và Eleventy dùng frontmatter YAML trong các tệp nội dung. Sự kết hợp của metadata YAML và nội dung Markdown phổ biến vì cú pháp key-value dễ đọc của YAML phù hợp tự nhiên ở đầu một tài liệu văn bản. Frontmatter JSON tồn tại nhưng hiếm khi được ưa thích.

Hiệu Năng

Đối với các pipeline xử lý dữ liệu, các benchmark tuần tự hóa nhất quán cho thấy JSON nhanh hơn YAML 5-10 lần để phân tích cho dữ liệu tương đương. Một cuộc gọi V8 JSON.parse() trên một tệp 1 MB hoàn thành trong vài mili giây. Phân tích YAML tương đương mất hàng chục mili giây. Đối với một máy chủ web xử lý hàng nghìn yêu cầu mỗi giây, sự khác biệt này quan trọng. Đối với một công cụ CLI đọc một tệp cấu hình một lần khi khởi động, nó không.

Nếu hiệu năng là mối quan tâm chính của bạn và bạn đang chọn giữa JSON và YAML cho một định dạng dữ liệu thông lượng cao, JSON thắng không nghi ngờ. Nếu bạn cần phân tích nhanh hơn, hãy cân nhắc các định dạng nhị phân như MessagePack hoặc Protocol Buffers cho giao tiếp giữa các dịch vụ.

Các Cân Nhắc Bảo Mật

Các parser YAML phức tạp hơn và có bề mặt tấn công lớn hơn các parser JSON. Rủi ro đáng kể nhất là thực thi code tùy ý qua giải tuần tự hóa YAML. Trong PyYAML của Python (trước khi safe_load được áp đặt theo mặc định), tải YAML không đáng tin cậy với hàm yaml.load() mặc định có thể thực thi code Python tùy ý được nhúng trong YAML. Các parser YAML PHP và Ruby đã có các lỗ hổng tương tự.

Quy tắc: luôn dùng tải an toàn khi phân tích YAML không đáng tin cậy. Trong Python, dùng yaml.safe_load(), không bao giờ yaml.load() mà không có đối số Loader. Trong Java, cấu hình constructor để hạn chế các kiểu được phép. Trong Ruby, dùng YAML.safe_load() thay vì YAML.load().

Các parser JSON không có lỗ hổng này vì hệ thống kiểu của JSON không có khái niệm các giá trị có thể thực thi. Một parser JSON chỉ có thể tạo các chuỗi, số, boolean, null, mảng và object — không bao giờ là code. Để xử lý dữ liệu người dùng không đáng tin cậy, JSON vốn an toàn hơn để phân tích.

Chuyển Đổi Giữa JSON Và YAML

Các định dạng tương thích về mặt ngữ nghĩa cho các loại dữ liệu phổ biến nhất. Chuyển đổi giữa chúng đơn giản khi dữ liệu không dùng các tính năng đặc thù YAML (anchor, các kiểu tùy chỉnh, các khối scalar). Dùng bộ chuyển đổi JSON to YAML để biến đổi các phản hồi API hoặc các tệp lockfile thành YAML dễ đọc cho tài liệu hóa hoặc gỡ lỗi. Dùng bộ chuyển đổi YAML to JSON để đưa cấu hình YAML vào các công cụ hoặc API nguyên bản JSON. Cả hai công cụ chạy trong trình duyệt — dữ liệu của bạn không bao giờ rời thiết bị.

JSON Formatter hữu ích để kiểm tra và xác thực cấu trúc JSON trước khi chuyển đổi. Nếu bạn đang làm việc với cấu hình di chuyển giữa các định dạng thường xuyên — ví dụ, các manifest Kubernetes cần được tuần tự hóa cho một cuộc gọi API — có cả hai bộ chuyển đổi trong dấu trang tiết kiệm thời gian.

Khuôn Khổ Quyết Định

Viết một phản hồi hoặc yêu cầu REST API? JSON.
Cấu hình Kubernetes, Docker Compose hoặc Ansible? YAML.
Viết một pipeline CI/CD? YAML.
Lưu trữ dữ liệu trong cơ sở dữ liệu? JSON.
Viết một tệp cấu hình có thể chỉnh sửa bởi người với bình luận? YAML.
Tạo cấu hình theo lập trình từ code? JSON.
Xử lý đầu vào người dùng không đáng tin cậy? JSON (parser an toàn hơn).
Pipeline dữ liệu thông lượng cao? JSON (hoặc định dạng nhị phân).
Dự án đã dùng một định dạng nhất quán? Khớp với quy ước hiện có.

Khi nghi ngờ, yếu tố quan trọng nhất là những người sẽ đọc và viết tệp. Nếu tệp chủ yếu được tạo bởi máy và được tiêu thụ bởi máy, sự đơn giản của JSON thắng. Nếu con người sẽ đọc nó, chỉnh sửa nó và quan tâm về sự rõ ràng của nó, sự biểu cảm của YAML đáng với độ phức tạp parser bổ sung.