So sánh & Tìm Khác biệt JSON

JSON Diff là gì?

JSON Diff (so sánh JSON) là quá trình phân tích hai cấu trúc dữ liệu JSON để xác định chính xác những thuộc tính nào đã được thêm, xóa hoặc thay đổi giá trị. Không giống so sánh văn bản thông thường, JSON diff hiểu cấu trúc dữ liệu — nó biết rằng thứ tự các khóa trong object không quan trọng, và mỗi phần tử mảng cần được so sánh theo vị trí.

Công cụ này đặc biệt hữu ích trong phát triển phần mềm, nơi bạn cần so sánh phản hồi API giữa các phiên bản, kiểm tra thay đổi cấu hình, hoặc debug sự khác biệt trong dữ liệu. Thay vì đọc từng dòng thủ công, bạn nhận được báo cáo chính xác về mọi thay đổi.

Cách so sánh hoạt động

Công cụ sử dụng thuật toán so sánh sâu (deep diff) qua các bước:

• Phân tích cú pháp: Cả hai JSON được parse thành cấu trúc dữ liệu JavaScript, chuẩn hóa thứ tự khóa.
• Duyệt đệ quy: Thuật toán duyệt qua từng cấp của cây dữ liệu, so sánh giá trị tại mỗi đường dẫn (path).
• Phân loại khác biệt: Mỗi thuộc tính được phân vào 4 nhóm: thêm mới (+), xóa (-), thay đổi (~), hoặc giữ nguyên.
• Hiển thị kết quả: Hai chế độ xem — cấu trúc (bảng theo đường dẫn) và dòng (diff theo từng dòng JSON đã format).

Chế độ xem cấu trúc so với xem theo dòng

Chế độ cấu trúc (Structural) hiển thị từng thay đổi theo đường dẫn thuộc tính (ví dụ: users[1].name). Đây là chế độ tốt nhất khi bạn cần biết chính xác thuộc tính nào thay đổi, đặc biệt với JSON lồng nhau nhiều cấp.

Chế độ dòng (Line-by-Line) hiển thị diff giống git diff — mỗi dòng JSON được format đẹp và so sánh trực tiếp. Thích hợp khi bạn muốn xem tổng quan nhanh về thay đổi hoặc cần copy đoạn diff để chia sẻ với đồng nghiệp.

Các trường hợp sử dụng phổ biến

So sánh phản hồi API

Khi phát triển hoặc cập nhật API, so sánh response giữa phiên bản cũ và mới giúp phát hiện breaking changes. Ví dụ: field bị đổi tên, kiểu dữ liệu thay đổi, hoặc field mới được thêm vào mà client chưa xử lý.

Kiểm tra cấu hình

File cấu hình JSON (package.json, tsconfig.json, .eslintrc) thường xuyên thay đổi. So sánh trước và sau khi chỉnh sửa giúp đảm bảo bạn chỉ thay đổi những gì cần thiết, tránh lỗi do thay đổi không mong muốn.

Debug dữ liệu

Khi dữ liệu đầu ra không đúng như mong đợi, so sánh JSON thực tế với JSON kỳ vọng giúp xác định chính xác điểm sai lệch. Đặc biệt hữu ích trong pipeline xử lý dữ liệu (ETL) và kiểm thử tự động.

Thực hành tốt khi so sánh JSON

• Luôn format (pretty-print) JSON trước khi so sánh để kết quả dễ đọc hơn.
• Khi so sánh mảng lớn, lưu ý rằng so sánh theo chỉ số — nếu phần tử được chèn vào giữa, tất cả phần tử sau sẽ bị đánh dấu là thay đổi.
• Sử dụng chế độ cấu trúc cho JSON phức tạp lồng nhiều cấp, chế độ dòng cho JSON đơn giản.
• Copy kết quả diff để lưu vào tài liệu hoặc issue tracker cho mục đích theo dõi.
• Kiểm tra cả hai JSON đều hợp lệ trước khi so sánh — JSON không hợp lệ sẽ gây lỗi parse.