JSON 비교 (Diff)

온라인에서 두 JSON 파일 비교 및 차이점 찾기

일반적인 줄 단위 텍스트 비교 도구(git diff 등)로 JSON을 비교하면 데이터 내용은 동일하더라도 키 순서나 들여쓰기 차이로 인해 수많은 오탐(False Positive)이 발생합니다.

당사의 구조적 JSON Diff 엔진은 다음 3단계 자동화 과정을 통해 실질적인 데이터 차이만을 감지합니다:

1. 구문 표준화: 두 문서를 RFC 8259 규격을 지원하는 파서로 분석하여 메모리상에 계층 구조로 배치합니다.
2. 재귀적 키 경로 탐색: 모든 키-값 쌍과 중첩된 배열 항목에 명시적 JSON 경로(예: users[0].address.city)를 할당합니다.
3. 카테고리별 델타 출력: 추가, 삭제, 값 및 데이터 타입 변경 사항을 명확한 시각적 태그로 분류하여 표시합니다.

객체 키 순서 처리 (RFC 8259 표준 준수)

공식 JSON 사양(RFC 8259)에 따르면 객체는 순서가 없는 이름/값 쌍의 모음입니다. 따라서 {"a": 1, "b": 2}와 {"b": 2, "a": 1}은 의미론적으로 완전히 동일한 데이터입니다.

본 도구는 기본적으로 키 순서 무시 모드가 활성화되어 있어 불필요한 차이점을 걸러냅니다. 엄격한 순서 일치가 필요한 경우 옵션을 해제하세요.

배열 비교: 순서 유지 vs 순서 무시

객체 키와 달리 JSON 배열 요소는 순서가 정의되어 있습니다. 그러나 많은 REST 및 GraphQL API에서 태그 목록이나 권한 목록처럼 순서가 중요하지 않은 배열이 사용됩니다.

본 도구는 배열 순서 무시 옵션을 제공합니다. 활성화 시 요소의 위치에 관계없이 데이터 일치 여부를 판별하여 맨 앞에 항목이 추가되어 전체 배열이 변경된 것처럼 보이는 현상을 방지합니다.

JSON Diff 보고서 내보내기 및 공유

비교가 완료되면 RFC 6902 표준 JSON Patch 형식 또는 코드 리뷰용 Markdown 변경 로그로 보고서를 다운로드할 수 있습니다. 모든 파싱은 브라우저에서 로컬로 실행되므로 민감한 데이터도 안전합니다.

Python 및 Node.js에서 프로그래밍 방식으로 JSON 비교하기

테스트 자동화나 CI/CD 배포 파이프라인에서 JSON 비교를 수행할 때 사용하는 표준 구현 코드입니다:

Python (DeepDiff)

import json
from deepdiff import DeepDiff

# Load JSON files or API responses
with open('original.json') as f1, open('modified.json') as f2:
    original_data = json.load(f1)
    modified_data = json.load(f2)

# Deep structural diff with key-order independence
differences = DeepDiff(original_data, modified_data, ignore_order=False)

print("Added keys:", differences.get('dictionary_item_added', {}))
print("Removed keys:", differences.get('dictionary_item_removed', {}))
print("Values changed:", differences.get('values_changed', {}))
print("Type changes:", differences.get('type_changes', {}))

Node.js / TypeScript (fast-json-patch)

import fs from 'node:fs';
import { compare } from 'fast-json-patch';

// Read and parse documents locally
const original = JSON.parse(fs.readFileSync('original.json', 'utf8'));
const modified = JSON.parse(fs.readFileSync('modified.json', 'utf8'));

// Generate standard RFC 6902 JSON patch differences
const delta = compare(original, modified);
console.log('Structured differences:', delta);
// Output: [ { op: 'replace', path: '/user/age', value: 26 }, ... ]

터미널에서 jq와 diff 명령어로 JSON 비교하기

Unix 및 macOS 터미널 환경에서는 diff를 실행하기 전에 jq -S 명령어로 키 순서를 정렬합니다:

# Sort keys alphabetically with jq, then run unified diff
diff -u <(jq -S . original.json) <(jq -S . modified.json)

비교하기 전에 JSON 데이터를 정리해야 하나요? JSON 포매터로 서식을 맞추거나, JSON 유효성 검사기로 오류를 수정하고, JSON to CSV 변환기.