JSON 정리·압축기

붙여 넣으면 바로 정리되고, 다섯 가지 모양을 크기와 함께 고릅니다

JSON 정리·압축기는 한 줄로 뭉친 JSON을 읽기 좋게 펼치거나(정리, 포맷, beautify), 공백과 줄바꿈을 빼서 짧게 줄입니다(압축, minify). 입력하는 동안 결과가 바로 바뀌고, 위쪽 견본 카드 다섯 장이 2칸·4칸·탭·폭 맞춤·한 줄로 바꿨을 때의 생김새와 크기, 줄 수, gzip으로 보낼 때의 크기를 나란히 보여 줍니다. 쓸 곳에 맞는 모양을 고른 뒤 복사하거나 파일로 저장하면 됩니다.

이 도구는 값을 건드리지 않습니다. 숫자는 9007199254740993이나 1.50처럼 쓴 글자 그대로 옮기고, 같은 이름의 키가 두 번 나와도 둘 다 남깁니다. 바뀌는 것은 공백과 줄바꿈, 그리고 사용자가 고른 경우의 키 순서와 문자열 표기뿐입니다. 그 밖에 PHP가 \ud55c\uae00처럼 적어 보낸 한글을 글자로 풀고, 주석과 끝 쉼표가 섞인 설정 파일은 고쳐서 정리하며, 로그에서 복사한 {\"a\":1} 꼴의 JSON은 역슬래시를 풀어 줍니다.

JSON을 펼치거나 줄여야 하는 순간

JSON은 프로그램끼리 주고받으려고 만든 형식이라 사람이 읽기 좋은 모양으로 오지 않는 경우가 많습니다. 아래 같은 상황에서 이 도구를 씁니다.

• API 응답을 확인할 때: 브라우저 개발자 도구나 curl로 받은 응답은 대개 한 줄입니다. 2칸으로 펼치면 어떤 값이 어느 객체 안에 들어 있는지 바로 보입니다.
• 한글이 \uc8fc\ubb38처럼 보일 때: PHP의 json_encode와 파이썬의 json.dumps는 기본 설정에서 한글을 \u 이스케이프로 적습니다. 글자 표기를 '\u 풀기'로 바꾸면 같은 값을 한글로 읽을 수 있습니다.
• 설정 파일이나 테스트 기댓값을 비교할 때: 키 순서만 달라도 비교 도구는 거의 모든 줄이 바뀌었다고 표시합니다. 두 파일을 '이름순'으로 정리한 뒤 비교하면 실제로 다른 값만 남습니다.
• 로그에서 JSON을 꺼낼 때: 로그나 데이터베이스 칸에는 JSON이 문자열로 한 번 더 감싸져 {\"event\":\"login\"}처럼 남는 일이 흔합니다. 역슬래시를 풀거나 문자열 안의 JSON을 꺼내 정리합니다.
• 보내거나 저장할 크기를 줄일 때: 한 줄 압축은 바이트를 확실히 줄이지만, 서버가 gzip으로 압축해 보내는 응답이라면 차이가 작아집니다. 견본 카드의 gzip 크기로 실제 효과를 먼저 확인하세요.

쓰는 법

1. 입력 칸에 JSON을 붙여 넣습니다. '파일 열기'를 누르거나 .json 파일을 칸에 끌어다 놓아도 되며, 5 MB까지 엽니다.
2. 견본 카드에서 결과 모양을 고릅니다. 카드를 누르거나, 카드에 초점을 둔 채 방향키로 옮길 수 있습니다.
3. 필요하면 키 순서(원래 순서·이름순), 글자 표기(원문대로·\u 풀기·ASCII로), 폭 맞춤의 줄 길이(60·80·100·120칸)를 바꿉니다. 견본 카드의 숫자도 함께 바뀝니다.
4. 문법 오류가 있으면 결과 칸이 오류 진단으로 바뀝니다. 멈춘 줄과 칸, 그 부분의 원문을 보여 주고, 고칠 수 있는 표기라면 'N곳 고쳐서 정리' 단추가 나옵니다.
5. '결과 복사'로 클립보드에 담거나 '파일로 저장'으로 내려받습니다. 한 줄 모양은 파일 이름 끝이 .min.json으로 저장됩니다.

다섯 가지 모양 비교

다섯 모양은 같은 값을 담고 있으며 공백과 줄바꿈만 다릅니다. 아래 표는 화면의 첫 예시인 '한 줄 API 응답'(주문 정보 449바이트)을 각 모양으로 바꾼 결과입니다. 크기는 UTF-8 바이트이고, gzip은 브라우저의 gzip 압축으로 잰 크기입니다.

한 줄로 압축하면 2칸보다 바이트가 33% 줄지만, gzip으로 압축한 크기는 12%만 줄어듭니다. gzip이 반복되는 공백 묶음을 짧은 기호로 바꾸기 때문입니다. 그래서 웹 서버가 압축해서 보내는 응답이라면 공백을 지워서 얻는 이득이 생각보다 작고, 사람이 다시 읽을 로그나 설정은 정리된 모양으로 두어도 괜찮습니다. 반대로 압축이 적용되지 않는 곳, 예를 들어 글자 수 제한이 있는 입력 칸이나 환경 변수, 데이터베이스의 한 칸에 넣을 때는 한 줄 모양이 확실히 짧습니다. 탭은 깊이마다 1바이트만 쓰므로 2칸·4칸·탭 가운데 가장 작습니다.

폭 맞춤은 줄을 이렇게 나눕니다

폭 맞춤은 바깥 값부터 차례로 '이 객체나 배열을 한 줄로 쓰면 줄 길이 안에 들어가는가'를 봅니다. 들어가면 {"x": 1, "y": 2}처럼 한 줄로 쓰고, 넘치면 펼친 뒤 안쪽 값을 같은 방법으로 봅니다. 줄 길이에는 들여쓰기와 키 이름, 뒤에 붙는 쉼표까지 넣어서 셉니다. 한글·한자·가나·전각 글자와 그림 문자는 고정폭 글꼴에서 두 칸을 차지하므로 2칸으로 셉니다(유니코드 동아시아 문자 폭, UAX #11의 W·F 글자).

짧은 배열이 많은 데이터에서 효과가 큽니다. 지도 데이터 형식인 GeoJSON은 좌표 하나를 [경도, 위도] 숫자 배열로 적는데(RFC 7946 §3.1.1), 2칸으로 펼치면 숫자 하나마다 줄이 생깁니다. 예시 '좌표 목록(GeoJSON)'은 2칸이면 53줄이지만 폭 맞춤이면 좌표 하나가 한 줄씩 차지해 25줄이 됩니다.

다른 도구에서 같은 모양을 만들려면

프로그램 안에서 같은 모양을 만들어야 할 때 쓰는 옵션입니다. 아래 대응은 숫자 표기와 키 순서가 바뀌지 않고 문자열에 \u·\/ 같은 이스케이프가 없는 데이터에서 이 도구의 결과와 글자까지 같습니다. 자바스크립트는 값을 읽을 때 숫자와 키 순서를 바꿀 수 있으므로 '숫자와 중복 키' 절을 함께 보세요.

JSON.stringify의 들여쓰기는 10칸까지만 늘어나고, jq의 --indent는 7칸까지 받습니다. 파이썬은 indent를 주면 쉼표 뒤 공백을 빼고((",", ": ")), indent가 없으면 (", ", ": ")로 씁니다. PHP의 json_encode는 JSON_PRETTY_PRINT를 주면 4칸으로 정리하고, 기본값에서는 한글을 \u 이스케이프로, 슬래시를 \/로 적습니다. 글자 그대로 쓰려면 JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES를 함께 넘깁니다.

글자 표기: \u 이스케이프를 풀거나 만들기

JSON 문자열 안의 글자는 그대로 써도 되고, 역슬래시와 u 뒤에 16진수 네 자리를 붙여 써도 됩니다(RFC 8259 §7). 두 표기는 같은 값이라 어느 쪽으로 바꿔도 받는 프로그램이 읽는 내용은 같습니다. 기본값 '원문대로'는 입력한 표기를 건드리지 않고, 아래 두 옵션을 고를 때만 문자열 글자를 바꿉니다.

'\u 풀기'는 제어 문자, 폭 없는 공백, 줄·문단 구분 문자, 일반 공백과 헷갈리는 특수 공백(U+00A0 등), 한글 채움 문자(U+3164)나 이체 선택자 같은 기본 무시 글자, 앞에 붙을 글자가 없는 결합 부호처럼 화면에서 구별할 수 없는 글자를 이스케이프로 남깁니다. 풀어 버리면 결과를 보고도 그 글자가 있는지 알 수 없기 때문입니다. 'ASCII로'는 반대 방향으로, ASCII 밖의 모든 글자를 소문자 \u 표기로 바꿉니다. 파이썬 json.dumps의 기본 출력(ensure_ascii=True), jq의 -a와 같은 모양이며, ASCII만 안전하게 지나가는 옛 시스템이나 전송 경로에 넣을 때 씁니다.

입력에 \u 이스케이프로 적힌 글자가 있으면 정리 결과 아래에 '이스케이프로 적힌 글자 N개'와 '글자로 풀기' 단추가 나옵니다. 예시 'PHP 응답(\u 한글)'은 처음부터 '\u 풀기'로 보여 주므로 입력 칸과 결과 칸을 비교해 보세요.

키 이름순 정렬

JSON 객체는 순서가 없는 이름·값 묶음입니다(RFC 8259 §1). 그래서 키 순서를 바꿔도 값은 같고, 순서를 하나로 정해 두면 두 JSON을 비교하거나 버전 관리 기록을 볼 때 실제로 바뀐 줄만 드러납니다. '이름순'은 다음 규칙으로 모든 단계의 객체 키를 늘어놓습니다.

• 유니코드 코드 포인트 순서로 비교합니다. 숫자 → 대문자 → 밑줄 → 소문자 → 악센트가 붙은 라틴 문자 → 한글 순이 되며, 예를 들어 2024, Zip, _id, age, é, 이름 차례입니다. jq의 -S와 파이썬의 sort_keys=True도 같은 순서입니다.
• 배열 안의 순서는 바꾸지 않습니다. 배열은 순서 자체가 뜻을 가지는 목록이기 때문입니다.
• 같은 이름의 키가 두 번 나오면 둘 다 남기고 원래의 앞뒤 순서를 지킵니다.
• 키는 이스케이프를 푼 글자로 비교합니다. "\u0041"과 "A"는 같은 이름으로 봅니다.

다만 사람이 읽기 좋게 항목 순서를 맞춰 둔 설정 파일은 원래 순서를 유지하는 편이 낫습니다. RFC 8259도 JSON 라이브러리마다 객체 멤버의 순서를 프로그램에 보여 주는지가 다르다고 적고 있어, 순서에 기대는 프로그램이 있다면 정렬한 결과를 그대로 넣지 마세요.

숫자와 중복 키는 그대로 옮깁니다

JSON을 프로그램의 값으로 읽은 뒤 다시 쓰는 방식은 겉으로 같아 보여도 내용이 바뀔 수 있습니다. 자바스크립트의 JSON.parse는 숫자를 64비트 부동소수점(IEEE 754 binary64)으로 바꾸므로 긴 정수의 끝자리가 달라지고, 정수 모양의 키를 앞으로 옮기며, 같은 이름의 키는 마지막 값만 남깁니다. 이 도구는 글자를 직접 읽어 공백만 다시 놓기 때문에 아래 표처럼 입력한 글자가 그대로 남습니다.

결과를 받는 프로그램이 같은 문제를 겪을 수 있다는 점은 별개입니다. RFC 8259는 binary64가 담는 정밀도와 범위를 넘지 않는 숫자라야 주고받는 쪽들이 같은 값으로 읽는다고 하고(§6), 이름이 겹치는 객체는 받는 소프트웨어마다 마지막 값만 쓰거나 오류를 내거나 모두 보고하는 등 동작이 다르다고 적습니다(§4). 긴 식별 번호는 문자열로 주고받고, 중복 키는 하나로 정리해서 보내세요. 정리 결과 아래의 주의 칩이 이런 값을 알려 주고, 칩을 누르면 입력 칸에서 그 자리를 선택합니다.

정리가 안 될 때: 자주 나오는 오류와 자동 고침

결과 칸이 오류 진단으로 바뀌면 검사가 멈춘 줄과 칸, 그 부분의 원문 조각을 보여 줍니다. 실제 실수는 표시한 자리 바로 앞에 있는 경우가 많습니다. 아래 표기는 '고쳐서 정리'나 '역슬래시 풀어서 정리'로 한 번에 JSON 문법으로 바꿀 수 있으며, 줄 배치는 그대로 두고 표시한 곳만 바꿉니다.

자동으로 고치지 않는 경우도 있습니다. 응답이 중간에 잘려 괄호가 닫히지 않았다면 어디까지가 원래 데이터인지 알 수 없으므로, 오류 진단은 끝에 붙여야 할 닫는 글자만 알려 줍니다. 007처럼 앞자리에 0이 붙은 숫자는 숫자로 볼지 글자로 볼지 사람이 정해야 해서 바꾸지 않습니다. 이럴 때는 '입력 칸에서 보기'로 그 자리를 선택해 직접 고치거나, 오류 위치와 원인을 더 자세히 보여 주는 JSON 검사기를 쓰세요. NaN을 null로 바꾸는 것처럼 값이 달라지는 고침도 있으니 결과를 한 번 확인하세요.

자주 틀리는 경우

• 고쳐서 정리한 결과로 원본 설정 파일을 덮어쓰기: 자동 고침은 주석을 지웁니다. 주석이 있던 JSONC 파일은 원본을 따로 두고, 정리한 결과는 JSON만 받는 곳에 넣으세요.
• 한쪽 파일만 이름순으로 정렬하고 비교하기: 순서 차이 때문에 거의 모든 줄이 바뀐 것으로 나옵니다. 비교할 두 파일을 같은 옵션으로 정리하세요.
• '\u 풀기' 결과를 ASCII만 받는 곳에 넣기: 풀어 쓴 한글은 UTF-8 바이트로 나갑니다. 받는 쪽이 UTF-8을 처리하지 못하면 'ASCII로'를 고르세요.
• 정리한 결과를 다시 JSON.parse로 읽고 숫자를 믿기: 이 도구는 9007199254740993을 그대로 두지만, 자바스크립트로 다시 읽으면 9007199254740992가 됩니다.
• 한 줄 압축만으로 전송량을 줄이려 하기: gzip으로 보내는 응답에서는 차이가 크지 않습니다. 쓰지 않는 필드를 빼는 편이 더 많이 줄입니다.
• JSONL(한 줄에 JSON 하나)을 한 문서로 붙여 넣기: 첫 값이 끝난 뒤 글자가 더 있다는 오류가 납니다. JSON 배열 ↔ JSONL 변환기로 배열로 바꾼 뒤 정리하세요.

한계와 주의

• 결과는 표준 JSON(RFC 8259)으로만 냅니다. JSONC·JSON5의 주석과 끝 쉼표는 자동 고침으로 지운 뒤 정리할 수 있지만, 주석을 남긴 채 정리하지는 않습니다.
• 5 MB, 중첩 500단계까지 처리합니다. 결과가 30만 자를 넘으면 속도를 위해 색 입히기를 생략하고 글자만 보여 줍니다.
• 폭 맞춤의 글자 폭은 고정폭 글꼴을 기준으로 센 근삿값입니다. 결합 문자나 일부 기호는 글꼴에 따라 실제 폭이 다를 수 있습니다.
• 문법만 확인합니다. 필수 키, 값의 종류, 범위 같은 데이터 규칙(JSON Schema)은 검사하지 않습니다.
• gzip 크기는 이 브라우저의 기본 gzip 압축으로 잰 값이라 서버의 압축 단계나 다른 압축 방식(br 등)을 쓰면 달라집니다.
• 입력은 저장하지 않습니다. 새로 고침하면 첫 예시로 돌아갑니다.

기준일 RFC 8259·RFC 7946·RFC 9110, PHP·Python·jq·MDN 문서, UAX #11(Unicode 18.0.0)은 2026-10-22에 원문으로 확인했습니다. 크기 표와 PHP·jq·파이썬의 출력은 같은 날 Chromium, PHP 8.5.12, jq 1.7.1, Python 3.14로 실제로 만들어 비교했습니다.

출처

• 01IETF RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format§1 객체는 순서 없는 묶음, §2 공백 네 가지, §4 이름은 고유해야 하며 중복 처리는 구현마다 다름, §6 binary64, §7 이스케이프와 서로게이트 쌍, §8.1 UTF-8과 BOM
• 02PHP 매뉴얼: JSON 상수JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, JSON_UNESCAPED_UNICODE(기본은 \uXXXX로 이스케이프)
• 03Python 문서: json 모듈ensure_ascii 기본값 True, indent, separators 기본값, sort_keys
• 04MDN: JSON.stringify()space 인수는 10칸까지
• 05jq 매뉴얼--indent n(7칸까지), --tab, --sort-keys(-S), --compact-output(-c), --ascii-output(-a), 키 정렬은 유니코드 코드 포인트 순
• 06Unicode UAX #11: East Asian WidthUnicode 18.0.0, 넓은 글자(W)와 전각 글자(F)
• 07IETF RFC 7946: The GeoJSON Format§3.1.1 위치는 경도, 위도 순서의 숫자 배열
• 08IETF RFC 9110: HTTP Semantics§8.4 Content-Encoding, §8.4.1.3 gzip
• 09MDN: CompressionStream브라우저 안에서 gzip으로 압축하는 표준 API, 2023년 5월부터 주요 브라우저 지원

자주 묻는 질문

함께 쓰는 도구