Định dạng và kiểm tra JSON

Acrafto Team Nhà phát triển
Cập nhật
Đang chờ dữ liệu. Dán JSON vào ô phía trên hoặc kéo thả tệp .json.

Dán JSON bất kỳ vào ô phía trên, JSON formatter và validator này sẽ kiểm tra dữ liệu ngay khi bạn nhập. Dữ liệu hợp lệ được định dạng đẹp với mức thụt lề bạn chọn, hoặc rút gọn thành một dòng duy nhất. Dữ liệu không hợp lệ nhận thông báo lỗi chính xác kèm dòng và cột, một đoạn trích được tô sáng và, với các lỗi thường gặp, cách sửa chỉ bằng một cú nhấp. Mọi thứ chạy trong trình duyệt của bạn, nên phản hồi API, tệp cấu hình và dữ liệu xuất ra không bao giờ rời khỏi máy tính của bạn.

JSON formatter này làm được gì

  • Định dạng JSON (beautify) với 2 dấu cách, 4 dấu cách hoặc tab. Kết quả giữ nguyên thứ tự khóa ban đầu, trừ khi bạn đánh dấu Sắp xếp khóa.
  • Rút gọn JSON (minify) bằng cách bỏ ký tự trắng thừa bên ngoài chuỗi. Khoảng trắng bên trong chuỗi được giữ. Chỉ số kích thước dưới kết quả cho biết bạn đã tiết kiệm được bao nhiêu byte.
  • Kiểm tra JSON trực tiếp theo RFC 8259, để kiểm tra cú pháp. Trạng thái hợp lệ không xác nhận schema, trường bắt buộc hoặc ý nghĩa dữ liệu của ứng dụng.
  • Tự động sửa lỗi thường gặp: dấu phẩy thừa, dấu nháy đơn, khóa không có dấu nháy, chú thích, giá trị kiểu Python như True, None và NaN, các số như .5 hoặc +1.
  • Mở tệp bằng nút Mở tệp hoặc kéo thả tệp .json vào ô nhập, sau đó tải kết quả xuống hoặc đưa nó trở lại ô nhập để xử lý thêm một lượt.

Vì sao thông báo lỗi quan trọng hơn màu đỏ

Công cụ này có bộ phân tích cú pháp (parser) riêng, ghi nhớ vị trí bắt đầu của từng token. Khi dừng lại, nó cho bạn biết dòng và cột, trích đoạn dòng đó với dấu mũ ngay dưới ký tự gây lỗi, cùng một gợi ý dễ hiểu như Có thể đang thiếu dấu phẩy giữa hai thuộc tính. Nút Đi tới lỗi đưa con trỏ thẳng đến vị trí đó trong ô nhập.

Ví dụ các lỗi cú pháp thường gặp:

Đầu vàoVấn đềJSON đúng
{'name': 'Lan'}dấu nháy đơn{"name": "Lan"}
{name: "Lan"}khóa không có dấu nháy{"name": "Lan"}
[1, 2, 3,]dấu phẩy thừa[1, 2, 3]
{"a": 1 "b": 2}thiếu dấu phẩy{"a": 1, "b": 2}
{"ok": True}giá trị kiểu Python{"ok": true}
{"x": 007}chữ số 0 ở đầu{"x": 7} hoặc {"x": "007"}
// commentchú thíchkhông được phép trong JSON

Nút Sửa giúp tôi xử lý được tất cả các lỗi trên, trừ thiếu dấu phẩy và chữ số 0 ở đầu. Cách sửa được thiết kế thận trọng một cách có chủ ý: nó không bao giờ đoán dấu phẩy bị thiếu nằm ở đâu, vì chèn sai chỗ sẽ làm thay đổi ý nghĩa của dữ liệu, còn 007 có thể là số 7 hoặc là một mã. Trong những trường hợp này, bạn sẽ nhận được vị trí chính xác của lỗi.

Giữ cách viết số lớn và thứ tự khóa

Nhiều formatter hoạt động bằng cách gọi JSON.parse rồi JSON.stringify. Vòng chuyển đổi đó âm thầm làm hỏng dữ liệu. Một ID lớn như 1234567890123456789 vượt quá giới hạn 2^53 của số trong JavaScript và trở thành 1234567890123456800. Giá trị 1.0 biến thành 1, còn 1e3 thành 1000. Formatter này không bao giờ chuyển số sang dạng dấu phẩy động. Nó sao chép từng giá trị đúng như khi được viết, nên kết quả là bản định dạng lại trung thực của đầu vào chứ không phải một cách diễn giải lại. Điều tương tự áp dụng cho chuỗi escape bên trong chuỗi: "\u00e9" vẫn giữ nguyên là "\u00e9" và không bị đổi thành "é".

Thứ tự khóa cũng được giữ nguyên. Đặc tả JSON nói rằng các thành phần của đối tượng không có thứ tự, nhưng tệp cấu hình, test fixture và code review sẽ dễ đọc hơn nhiều khi thứ tự ổn định. Để có cùng thứ tự khóa khi so sánh hai phản hồi API, hãy bật Sắp xếp khóa và cả hai tài liệu sẽ liệt kê thuộc tính theo thứ tự bảng chữ cái ở mọi cấp lồng nhau.

Định dạng JSON hay rút gọn JSON: khi nào dùng cách nào

JSON được định dạng đẹp là dành cho con người. Hãy dùng nó khi bạn xem xét một phản hồi API, viết package.json, tsconfig.json hoặc tài liệu OpenAPI, hay khi lưu fixture trong một repository mà mỗi diff nên thể hiện một thay đổi trên một dòng. Hai dấu cách là quy ước trong thế giới JavaScript, bốn dấu cách phổ biến trong các dự án Python và .NET, còn tab cho phép mỗi người đọc tự chọn độ rộng.

Rút gọn có thể giảm byte khi truyền hoặc lưu trữ. Mức giảm, kể cả sau Gzip, phụ thuộc tài liệu; không có tỷ lệ giảm cố định. Chỉ số kích thước dưới kết quả cho thấy chênh lệch chính xác với tài liệu của bạn.

Làm việc với JSON trong terminal và trình soạn thảo

Với những tệp bạn xử lý thường xuyên, công cụ dòng lệnh có thể thuận tiện hơn. jq . file.json định dạng đẹp, jq -c . file.json rút gọn, còn python -m json.tool file.json hoạt động ở bất cứ đâu có cài Python. Visual Studio Code định dạng JSON bằng Shift+Alt+F và kiểm tra theo schema khi bạn thêm thuộc tính $schema. Trang này dành cho các trường hợp còn lại: một phản hồi sao chép từ tab Network, một dòng log, một đoạn cấu hình lấy từ wiki, hoặc kiểm tra nhanh trên máy mà bạn không thể cài đặt gì.

Công cụ liên quan trên trang này: bộ mã hóa và giải mã Base64 giải mã phần payload của JWT, vốn là JSON được mã hóa bằng Base64url. Công cụ chuyển đổi Unix timestamp đổi số như createdAt thành ngày giờ khi trường đó thực sự chứa Unix timestamp, còn bộ giải mã UUID cho biết phiên bản và dấu thời gian của các định danh trong dữ liệu của bạn. Các tiện ích khác có trong mục công cụ cho nhà phát triển.

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

JSON của tôi có được tải lên máy chủ không? Không. Việc phân tích, định dạng và sửa lỗi đều chạy hoàn toàn trong trình duyệt của bạn bằng JavaScript. Sau khi trang đã tải xong, bạn có thể ngắt kết nối mạng và công cụ vẫn tiếp tục hoạt động. Không có gì được ghi lại hay lưu trữ.
Tại sao trình kiểm tra từ chối chú thích trong khi trình soạn thảo của tôi chấp nhận? Chính tác giả của JSON, Douglas Crockford, đã cố ý loại bỏ chú thích khỏi định dạng này để ngăn việc dùng chúng làm chỉ thị cho parser. Các tệp như tsconfig.json hay .vscode/settings.json về mặt kỹ thuật là JSONC, một phần mở rộng của JSON mà các trình soạn thảo hỗ trợ. Các parser nghiêm ngặt trong API, cơ sở dữ liệu và hầu hết ngôn ngữ lập trình đều từ chối chúng. Nút sửa lỗi thử xóa chú thích; những lỗi khác còn lại vẫn được báo và nội dung phải được kiểm tra lại.
Tôi có thể định dạng JSON Lines hoặc nhiều đối tượng cùng lúc không? Một tài liệu JSON chứa đúng một giá trị. Nếu bạn dán nhiều đối tượng phân tách bằng dấu phẩy hoặc dấu xuống dòng, trình kiểm tra sẽ dừng ở giá trị thừa đầu tiên. Hãy bọc chúng trong dấu ngoặc vuông để tạo thành một mảng, rồi định dạng. Nút sửa lỗi không tự làm việc này vì nó không thể biết đầu vào có được dự định là một tài liệu hay không.
Kích thước tối đa là bao nhiêu? Không có giới hạn cố định. Khả năng xử lý và thời gian phụ thuộc bộ nhớ, kích thước và cấu trúc dữ liệu. Tô sáng cú pháp được tắt khi vượt quá khoảng 400 kB để trang vẫn phản hồi nhanh, nhưng sao chép và tải xuống vẫn hoạt động bình thường.
Sắp xếp khóa có làm thay đổi dữ liệu không? Thứ tự phần tử mảng được giữ, còn khóa đối tượng được sắp lại. Byte của tài liệu thay đổi nên mã băm, chữ ký hoặc so sánh nhị phân có thể khác. Đây không phải chuẩn hóa mật mã. Với khóa trùng tên, các parser còn có thể diễn giải khác nhau; không nên coi sắp xếp là bảo đảm giữ nguyên ý nghĩa trong mọi hệ thống.
Làm thế nào để escape JSON khi nhúng vào một chuỗi? Trước tiên hãy rút gọn, sau đó escape mọi dấu gạch chéo ngược và dấu nháy kép. Nhiều ngôn ngữ hỗ trợ việc này trực tiếp: JSON.stringify(JSON.stringify(obj)) trong JavaScript hoặc json.dumps(json.dumps(obj)) trong Python tạo ra một chuỗi JSON chứa văn bản JSON.

Tôi sẽ đánh giá cao nếu bạn có thể chia sẻ những trang này với bạn bè, đánh dấu trang hoặc liên kết đến chúng. Cảm ơn! 🙏