Chuyển YAML sang JSON YAML Ain't Markup Language ↔ JavaScript Object Notation Miễn phí Trực tuyến An toàn

Vì sao người ta chuyển YAML sang JSON

YAML là ký pháp mà người ta chọn khi phải viết dữ liệu bằng tay. Nó dùng thụt lề thay cho ngoặc nhọn, cho phép chú thích và đọc gần như một dàn ý, đó là lý do nó trở thành món ưa thích cho cấu hình: quy trình dựng, định nghĩa container, tệp triển khai, cài đặt trang tĩnh, công cụ tài liệu và vô số cấu hình ứng dụng. JSON là ký pháp mà chương trình thích nhận. Nó nghiêm ngặt, không có chú thích, và mọi ngôn ngữ lập trình đều đọc được nó bằng thư viện chuẩn. Khi một tệp viết cho con người phải được trao cho một chương trình, một API hay một công cụ chỉ nhận JSON, cần một phép chuyển đổi. Đó là lý do người ta chuyển YAML sang JSON: họ có dữ liệu ở dạng dễ chịu để viết, và đích đến muốn dạng dễ phân tích.

Các tình huống là chuyện thường ngày. Một lập trình viên duy trì một cấu hình bằng YAML và phải gửi nó cho một dịch vụ dưới dạng JSON. Một nhóm muốn xác thực một tệp cài đặt bằng công cụ kiểm tra JSON. Một người viết có phần front matter bằng YAML và muốn đưa nó cho một đoạn mã. Một sinh viên muốn xem thụt lề của một tệp YAML ánh xạ sang ngoặc nhọn thế nào. Trong mỗi trường hợp dữ liệu là như nhau, và chỉ ký pháp đổi.

Trang này chuyển YAML sang JSON ngay trong trình duyệt của bạn. Tệp của bạn được đọc và ghi ở đây, nên không bao giờ rời khỏi thiết bị của bạn, điều quan trọng với các tệp cấu hình, vốn thường chứa địa chỉ, tên hệ thống nội bộ và đôi khi là bí mật. Và trang cho bạn biết trước điều phép chuyển giữ lại và điều nó không thể, thay vì để bạn tự khám phá. Bên dưới bạn sẽ thấy phép chuyển đổi hoạt động thế nào, điều gì mất cùng chú thích và nên mong đợi gì ở ngày và thẻ.

Phép chuyển đổi hoạt động thế nào

Cùng những hình dạng trong cả hai ký pháp

YAML của bạn được đọc bên trong trình duyệt của bạn, và cấu trúc của nó được viết ra thành JSON. Hai bên chứa cùng những hình dạng: ánh xạ, danh sách, chuỗi, số, boolean và null sang mà không mất. Một ánh xạ trong YAML thành một đối tượng trong JSON, một chuỗi tuần tự thành một mảng, và các giá trị vô hướng giữ kiểu của chúng. Một dòng như port: 8080 cho một số, và enabled: true cho một boolean.

Mỏ neo và bí danh được mở rộng

YAML có một tính năng JSON thiếu: bạn có thể đánh dấu một khối bằng một mỏ neo và tham chiếu nó ở nơi khác bằng một bí danh, để khỏi lặp lại. Mỏ neo và bí danh được mở rộng, nên kết quả tự đứng được. Mỗi nơi bí danh xuất hiện giờ chứa một bản sao đầy đủ của khối. JSON dài hơn, nhưng không cần biết gì về mỏ neo để đọc.

Thụt lề thành cấu trúc

Trong YAML, cấu trúc được biểu thị bằng thụt lề. Trong JSON, nó được biểu thị bằng ngoặc nhọn và ngoặc vuông. Công cụ chuyển đổi đọc thụt lề như tác giả đã định, và viết ngoặc nhọn cho bạn. Lỗi thụt lề, những lỗi YAML phổ biến nhất, được báo cáo chứ không bị đoán.

Điều gì được giữ lại

Mọi thứ là dữ liệu

Mọi thứ được giữ lại, vì hai bên chứa cùng những hình dạng: ánh xạ, danh sách, chuỗi, số, boolean và null sang mà không mất. Nếu nó là một giá trị trong YAML của bạn, nó là một giá trị trong JSON.

Thứ tự của các khóa

Các khóa giữ thứ tự chúng được viết, nên JSON đọc theo cùng trình tự với YAML.

Chuỗi nhiều dòng

Các chuỗi trải qua nhiều dòng trong YAML, viết bằng các kiểu khối, được mang sang dưới dạng chuỗi đơn với ngắt dòng bên trong, mà JSON viết dưới dạng chuỗi thoát. Chữ là như nhau.

Điều bạn nên biết trước khi chuyển YAML sang JSON

Chú thích và bố cục mất đi

Chú thích, dòng trống và lựa chọn giữa có dấu nháy và không dấu nháy là cách một tệp YAML đọc, không phải điều nó có nghĩa, và không cái nào sống sót, vì JSON không có chỗ để giữ chúng. Nếu YAML của bạn đầy chú thích giải thích, JSON sẽ không có cái nào. Hãy giữ YAML làm tệp mà con người đọc và chỉnh sửa, và coi JSON là một bản sao dẫn xuất.

Ngày không có dấu nháy đến dưới dạng chữ

Một ngày viết không có dấu nháy đến dưới dạng chữ, vì JSON không có ngày. Một dòng như released: 2026-03-14 cho chuỗi 2026-03-14. Chương trình đọc JSON phải diễn giải nó như một ngày nếu cần.

Thẻ tùy chỉnh không được tôn trọng

Thẻ tùy chỉnh không được tôn trọng: chỉ các kiểu chuẩn được đọc, cũng là điều giữ một tệp khỏi đòi hỏi thứ mà trang này không có. YAML cho phép các thẻ bảo một chương trình cụ thể dựng một đối tượng cụ thể. Những chỉ thị như vậy không có nghĩa gì ở đây, và công cụ chuyển đổi không theo chúng.

Cách chuyển YAML sang JSON ở đây

Thêm tệp của bạn

Thả tệp YAML lên trang hoặc chọn nó từ thiết bị của bạn. Nó được đọc bên trong trình duyệt của bạn và không được tải lên.

Chuyển đổi

Nhấn nút. Một tệp kích thước bình thường mất một lát. Hãy để trang mở cho đến khi xong.

Tải về và kiểm tra

Tải về JSON và mở nó trong một trình soạn thảo văn bản. Nhìn phần đầu và phần cuối, và kiểm tra rằng cấu trúc và kiểu là những gì bạn mong đợi.

Nhìn kỹ hơn vào YAML và JSON

Hai ký pháp cho cùng dữ liệu

YAML được thiết kế để con người viết và đọc dễ dàng. JSON được thiết kế để chương trình đọc và ghi dễ dàng. Chúng chồng nhau xa đến mức JSON gần như là một tập con của YAML, và một bộ đọc YAML thường đọc được JSON. Điều ngược lại không đúng, vì YAML có nhiều tính năng hơn. Chuyển YAML sang JSON là đi từ ký pháp phong phú hơn sang ký pháp nghiêm ngặt hơn, và từ bỏ phần thêm: chú thích, mỏ neo và thẻ.

Vì sao lỗi thụt lề quan trọng

Vì YAML dựa vào thụt lề, một dòng lệch hàng đổi nghĩa, và đôi khi nó vẫn phân tích được. Một khóa lẽ ra nằm trong một khối lại ở ngoài. JSON làm những lỗi như vậy hiện ra, vì ngoặc nhọn cho thấy chính xác mỗi khóa rơi vào đâu. Chuyển đổi vì thế cũng là cách tiện để kiểm tra một tệp có nghĩa như bạn nghĩ không.

Dấu tab

YAML không cho phép dấu tab để thụt lề. Nếu tệp của bạn chứa chúng, phép chuyển đổi sẽ báo một vấn đề. Hãy thay các dấu tab bằng dấu cách và thử lại.

Các tình huống phổ biến chi tiết

Cấu hình cho dịch vụ và công cụ

Nhiều công cụ chỉ nhận cấu hình bằng JSON, hoặc xác thực nó theo một lược đồ JSON. Hãy chuyển YAML của bạn và dùng kết quả ở nơi cần JSON.

Kiểm tra một tệp thực sự nói gì

Khi một cấu hình YAML hành xử kỳ lạ, chuyển nó sang JSON cho thấy cấu trúc không mơ hồ. Khóa đặt sai chỗ và kiểu sai nổi bật lên.

Nuôi các đoạn mã và API

Một API nhận thân JSON có thể được đưa nội dung của một tệp YAML sau khi chuyển đổi. Nó cho phép bạn giữ tệp ở dạng bạn thích chỉnh sửa.

Tài liệu và tệp nội dung

Các trình tạo trang tĩnh và công cụ tài liệu dùng YAML cho front matter và tệp dữ liệu. Chuyển chúng cho phép các công cụ khác đọc cùng dữ liệu.

Lời khuyên thực tế trước khi bạn chuyển YAML sang JSON

Kiểm tra thụt lề

Dùng dấu cách, không dùng tab, và giữ cùng độ rộng ở mỗi cấp. Hầu hết trình soạn thảo có thể hiển thị khoảng trắng và tô sáng lỗi YAML.

Đặt dấu nháy cho giá trị phải giữ là chữ

Một giá trị trần như yes, no hay 1.0 có thể được đọc là boolean hoặc số. Nếu bạn muốn nói chữ, hãy đặt dấu nháy quanh nó. Điều này bảo vệ số phiên bản, mã và chữ viết tắt quốc gia.

Giữ chú thích trong YAML

Vì chú thích không sống sót, hãy giữ YAML làm bản gốc, cùng lời giải thích của nó, và tạo lại JSON khi cần.

Tệp lớn

Mọi thứ chạy trên thiết bị của bạn, nên một tệp rất lớn cần bộ nhớ. Với tệp nhiều megabyte, hãy dùng máy tính, và chia dữ liệu nếu trang vất vả.

Những câu hỏi người ta hỏi trước khi chuyển đổi

Chú thích của tôi đâu rồi?

Chúng đã mất. JSON không có chỗ giữ chú thích, và chúng là cách một tệp đọc, không phải điều nó có nghĩa.

Vì sao ngày của tôi là một chuỗi?

Vì JSON không có ngày. Một ngày viết không có dấu nháy đến dưới dạng chữ.

Điều gì xảy ra với mỏ neo và bí danh?

Chúng được mở rộng, nên kết quả tự đứng được.

Vì sao thẻ của tôi không hoạt động?

Thẻ tùy chỉnh không được tôn trọng. Chỉ các kiểu chuẩn được đọc.

Tệp của tôi có được tải lên không?

Không. Phép chuyển đổi chạy trong trình duyệt của bạn và tệp không bao giờ rời khỏi thiết bị của bạn.

Tôi có thể quay lại YAML không?

Có. JSON sang YAML viết dữ liệu trở lại ở dạng dễ đọc, dù không có chú thích mà bản gốc đã có.

Chọn khôn ngoan khi bạn chuyển YAML sang JSON

JSON có thực sự cần không?

Nếu công cụ nhận đọc YAML, hãy giữ YAML. Chỉ chuyển đổi khi cần JSON.

Các đích khác

Nếu đích là một tệp đánh dấu, JSON sang XML có thể theo sau. Với bảng, JSON sang CSV và JSON sang XLSX phục vụ bảng tính.

Giữ YAML

YAML là bản gốc, cùng chú thích và bố cục. Hãy giữ nó, và coi JSON là một bản sao.

Có được kết quả tốt sau khi chuyển đổi

Kiểm tra JSON trong một trình xem

Mở kết quả trong một trình soạn thảo hiểu JSON và thu gọn các đối tượng. Nếu cấu trúc trông như bạn mong đợi, nó vững.

Kiểm tra các kiểu

Nhìn vào các giá trị như phiên bản, mã và cờ. Hãy chắc chúng là chuỗi ở nơi bạn muốn chuỗi và là số ở nơi bạn muốn số.

Thu nhỏ để truyền tải

Nếu JSON sẽ được gửi qua mạng, có các công cụ loại bỏ khoảng trắng và làm nó nhẹ hơn. Dữ liệu vẫn như cũ.

Chuẩn bị YAML để nó chuyển đổi tốt

Giữ nó đơn giản

Khi bạn chuyển YAML sang JSON, YAML đơn giản chuyển tốt nhất: ánh xạ, danh sách và giá trị đơn giản. Các tính năng như thẻ tùy chỉnh bị bỏ qua, và mỏ neo chỉ làm tệp dài hơn.

Tường minh về kiểu

Đặt dấu nháy cho bất cứ thứ gì trông như kiểu khác. Tường minh an toàn hơn khôn khéo, và JSON sẽ mang chính xác điều bạn đã viết.

Thử với một phần nhỏ trước

Nếu tệp của bạn lớn, hãy lấy một đoạn vào một tệp thử và chuyển nó. Một cái nhìn nhanh vào kết quả cho thấy cấu trúc có như bạn mong đợi không.

Tận dụng tối đa khi bạn chuyển YAML sang JSON

Dùng phép chuyển đổi như một phép kiểm tra

Một trong những cách dùng tốt nhất của trang là như một chiếc gương. Khi bạn chuyển YAML sang JSON, ngoặc nhọn cho thấy chính xác thụt lề đã được hiểu thế nào. Nếu một khóa nằm sai cấp, hoặc một danh sách nuốt một mục lẽ ra không nên, điều đó rõ ràng trong kết quả. Nhiều người chuyển một cấu hình chỉ để xác nhận nó nói đúng điều họ muốn.

Để ý những bất ngờ phổ biến về kiểu

YAML đọc một số từ trần như kiểu khác. Từ no có thể được đọc là false, một phiên bản như 1.10 là số 1.1, và một mã quốc gia như NO là boolean trong một số bộ đọc. Công cụ chuyển đổi theo các kiểu chuẩn, nên các giá trị trông như số hoặc boolean sẽ được gán kiểu như vậy. Nếu bạn muốn chúng vẫn là chữ, hãy đặt dấu nháy quanh chúng trong YAML trước khi chuyển đổi.

Chuỗi dài và kiểu khối

YAML cung cấp các kiểu khối cho chữ dài, một kiểu giữ ngắt dòng và một kiểu gấp chúng thành dấu cách. Cả hai được đọc như các tác giả của định dạng đã định, và chuỗi kết quả được viết vào JSON với ngắt dòng của nó dưới dạng chuỗi thoát. Chữ là như nhau, và JSON đơn giản là kém dễ chịu hơn cho con người đọc, đó là lý do YAML tồn tại.

Nhiều tài liệu trong một tệp

YAML cho phép nhiều hơn một tài liệu trong một tệp, ngăn cách bằng ba dấu gạch ngang. Nếu tệp của bạn có nhiều, hãy nghĩ xem bạn muốn cái nào. Tách chúng thành các tệp riêng và chuyển từng cái, để mỗi tệp JSON chứa một tài liệu.

Bí mật trong cấu hình

Tệp cấu hình đôi khi chứa mật khẩu, mã thông báo và khóa. Vì phép chuyển đổi diễn ra trong trình duyệt của bạn, không có gì được gửi đi đâu. Dù vậy, đừng để tệp đã chuyển đổi trong một thư mục chia sẻ hay một email, và hãy xóa các bí mật trước khi bạn chuyển nó cho người khác.

Giữ hai định dạng đồng bộ

Nếu một dự án cần cả phiên bản YAML và JSON của cùng dữ liệu, hãy coi một cái là nguồn và tạo lại cái kia mỗi lần nó thay đổi. Mỗi khi bạn chuyển YAML sang JSON, hãy làm từ YAML hiện tại, và đừng vá JSON bằng tay. Như vậy hai bên không thể lệch nhau.

Xác thực theo một lược đồ

Nhiều công cụ kiểm tra JSON theo một lược đồ, một mô tả những khóa và kiểu nào được phép. Một cấu hình YAML không phải lúc nào cũng kiểm tra trực tiếp được, nhưng dạng JSON của nó thì được. Đây là một lý do phổ biến để chuyển YAML sang JSON: để xác thực tệp trước khi nó đến một hệ thống sẽ từ chối nó.

Quyền riêng tư và xử lý

Vì sao chuyển đổi cục bộ quan trọng với cấu hình

Tệp cấu hình thường chứa địa chỉ, tên hệ thống nội bộ và đôi khi là khóa và mật khẩu. Nhiều công cụ chuyển đổi trực tuyến tải tệp của bạn lên máy chủ, xử lý và gửi lại kết quả, và trong một thời gian một bản sao nằm trên một cỗ máy bạn không kiểm soát. Ở đây trình duyệt của chính bạn làm việc, nên tệp ở lại trên thiết bị của bạn.

Điều gì xảy ra khi bạn rời đi

Khi bạn đóng trang, tệp đã chuyển đổi biến mất khỏi trình duyệt, nên hãy tải nó về trước. Không có gì về tệp của bạn được giữ.

Nếu có gì trục trặc

Trang báo lỗi YAML

Hãy nhìn dòng nó chỉ ra. Nguyên nhân phổ biến là dùng tab để thụt lề, thiếu dấu cách sau dấu hai chấm, hoặc một dấu nháy không đóng.

Cấu trúc không như tôi mong đợi

Hãy kiểm tra thụt lề. Một dòng lệch một dấu cách thuộc về một khối khác với điều bạn định.

Trang bị treo với một tệp lớn

Mọi thứ chạy trên thiết bị của bạn, và một tệp lớn cần bộ nhớ. Hãy thử lại trên máy tính, hoặc chia dữ liệu.

Công cụ liên quan

Cùng họ công cụ bao gồm các việc lân cận. Để quay lại, hãy dùng JSON sang YAML. Với đánh dấu, XML sang JSON và JSON sang XML chuyển giữa hai định dạng đó. Với bảng, có JSON sang CSV, CSV sang JSON, JSON sang XLSX và XLSX sang JSON.

Một ví dụ đã giải

Giả sử nhóm của bạn giữ cài đặt của một ứng dụng trong một tệp YAML có chú thích, mỏ neo cho các khối lặp lại và một ngày phát hành, và một công cụ giám sát muốn cùng các cài đặt đó dưới dạng JSON. Bạn thả tệp vào đây và nhấn nút. Một lát sau bạn tải về một JSON trong đó các mỏ neo được mở rộng, ngày là một chuỗi và các chú thích đã mất. Bạn gửi nó cho công cụ. YAML ở lại trong kho mã của bạn, cùng chú thích, như tệp mà con người chỉnh sửa.

Một danh sách kiểm tra ngắn

Trước khi chuyển đổi

Kiểm tra thụt lề. Đặt dấu nháy cho giá trị phải giữ là chữ. Giữ YAML.

Trong khi chuyển đổi

Ở lại trang cho đến khi tệp sẵn sàng.

Sau khi chuyển đổi

Mở JSON, kiểm tra cấu trúc và các kiểu, và thử nó với công cụ sẽ đọc nó.

Những sai lầm thường gặp

Mong chú thích sống sót

Chúng không. Hãy giữ YAML cho lời giải thích.

Để các giá trị mơ hồ ở dạng trần

Các giá trị như yes, no và 1.0 có thể được đọc là kiểu khác. Hãy đặt dấu nháy cho chúng.

Dùng tab

YAML không cho phép tab để thụt lề. Hãy dùng dấu cách.

Tệp của bạn ở lại trên thiết bị của bạn

Phép chuyển đổi diễn ra cục bộ. Tệp của bạn được trình duyệt của chính bạn đọc, viết lại ở đó và trả lại dưới dạng JSON. Không có gì được tải lên, nên không có bản sao nào trên máy chủ và không ai khác đọc được. Với cấu hình có nội dung riêng tư, đó là cách an toàn để chuyển YAML sang JSON.

Tóm tắt

Để chuyển YAML sang JSON ở đây, hãy thả tệp và nhấn nút. Nó được đọc và ghi trong trình duyệt của bạn, nên tệp không bao giờ rời khỏi thiết bị của bạn. Mọi thứ được giữ lại, vì hai bên chứa cùng những hình dạng: ánh xạ, danh sách, chuỗi, số, boolean và null sang mà không mất. Mỏ neo và bí danh được mở rộng, nên kết quả tự đứng được. Chú thích, dòng trống và lựa chọn giữa có dấu nháy và không dấu nháy là cách một tệp YAML đọc, không phải điều nó có nghĩa, và không cái nào sống sót, vì JSON không có chỗ để giữ chúng. Một ngày viết không có dấu nháy đến dưới dạng chữ, vì JSON không có ngày. Thẻ tùy chỉnh không được tôn trọng: chỉ các kiểu chuẩn được đọc.