Tool overview
JSON 포맷터란?
JSON 포맷터는 압축되거나 지저분한 JSON 텍스트를 일관된 들여쓰기, 줄 바꿈, 구문 검증으로 재구성하는 도구입니다.
왜 JSON 포맷터를 사용하나요?
API 응답, 설정 파일, 로그를 디버깅할 때 가독성을 높이며 기본 데이터 구조는 변경하지 않습니다.
주요 기능
즉시 구문 강조 및 오류 감지, 포맷/미니파이 모드, 트리 탐색, 100% 클라이언트 사이드 프라이버시, 원클릭 복사.
사용 방법
위 도구에서 정확한 결과를 얻기 위한 단계입니다.
- 편집기에 JSON을 붙여넣거나 .json 파일을 업로드하거나 최근 스냅샷을 불러옵니다.
- 포맷으로 들여쓰기와 줄 바꿈을 추가하거나 미니파이로 한 줄 출력을 만듭니다.
- 트리 뷰로 중첩 객체와 배열을 탐색합니다.
- 배너에 표시된 검증 오류를 수정합니다.
- 포맷된 출력을 복사, 다운로드하거나 다른 도구로 전달합니다.
JSON Formatter — 완전 가이드 및 사용 사례
검증, beautify, minify, 트리 탐색, 구문 함정, 파싱 오류 수정, 대용량 JSON 팁, 형제 도구로 파이프까지 — 위 편집기에서 바로 실행할 수 있는 권위 있는 안내입니다.
JSON Formatter 가이드 — 여기서 시작
이 페이지는 DevUtilities로 브라우저에서 JSON을 검증·포맷·minify·탐색하는 정식 가이드입니다. 읽으면서 위 편집기를 쓰거나 아래 주제로 이동하세요. 파싱은 기기에 남고 페이로드는 업로드되지 않습니다.
JSON Formatter가 하는 일
JSON Formatter는 엄격한 ECMA-404 JSON용 클라이언트 워크숍입니다. 구문을 검증하고, 사람을 위해 beautify, 전송을 위해 minify, 중첩 트리를 탐색하며 첫 파싱 오류로 점프합니다.
얻는 것
- 첫 구문 오류로 줄/문자 점프가 있는 즉시 검증
- Beautify(들여쓰기) 및 Minify(한 줄) 모드
- 검색/필터가 있는 중첩 객체·배열 트리 뷰
- 복사, 다운로드, localStorage 기록 스냅샷, 형제 도구로 파이프
- 100% 브라우저 내 실행 — 독점 API 페이로드와 비밀에 안전
이 도구를 사용할 때
- API 응답이나 webhook 본문이 파싱에 실패해 정확한 오프셋이 필요할 때
- 커밋·배포 전 지저분한 설정 JSON을 정리해야 할 때
- 헤더, 쿼리 파라미터, 메시지 큐용 한 줄 페이로드가 필요할 때
- 텍스트 벽을 스크롤하지 않고 깊은 중첩을 탐색해야 할 때
다음 경우 형제 도구를 선호
- YAML ↔ JSON 변환이 필요 → YAML ↔ JSON
- 표 형식보내기가 필요 → JSON to CSV
- 합성 mock 배열이 필요 → JSON Generator
- codegen 전 OpenAPI lint가 필요 → OpenAPI Validator
Beautify vs minify vs 트리 탐색
페이로드의 다음 소비자 — 사람, 기계 또는 둘 다 — 에 따라 모드를 고릅니다.
Beautify vs minify
| 모드 | 출력 | 적합한 용도 |
|---|---|---|
| Beautify | 들여쓰기와 줄바꿈이 있는 JSON | 디버깅, 코드 리뷰, 중첩 설정 읽기 |
| Minify | 한 줄, 불필요한 공백 제거 | API 전송, 저장 크기, 문자열 임베딩 |
| 트리 탐색 | 접을 수 있는 객체/배열 노드 | 전체 파일을 다시 포맷하지 않고 깊은 키 찾기 |
| 검증만 | 오류 배너 + 줄로 점프 | 다른 곳으로 파이프하기 전 CI 스타일 검사 |
단계별: 검증, 포맷, 탐색, 파이프
이 도구가 돕는 방법
- 원시 JSON을 붙여넣거나 .json을 업로드하거나 localStorage의 최근 스냅샷을 로드합니다.
- 검증 배너를 읽습니다 — 무효하면 오류 줄을 클릭해 문제 문자로 점프합니다.
- 읽기 쉬운 들여쓰기는 Beautify, 프로덕션용 한 줄은 Minify를 선택합니다.
- 트리 뷰로 중첩 객체/배열을 펼치고 검색 도구 모음으로 키를 필터합니다.
- 출력을 복사, 파일 다운로드, 또는 JSON to CSV, YAML ↔ JSON, Text Diff로 파이프합니다.
- 민감한 페이로드의 로컬 복사가 더 이상 필요 없으면 기록 스냅샷을 지우거나 덮어씁니다.
사용 사례: 잘못된 API JSON 디버그
파트너 API가 200을 반환하지만 클라이언트가 본문을 잘못된 JSON으로 거부합니다. 로그에는 잘린 또는 수동 편집된 페이로드가 보입니다.
이 도구가 돕는 방법
- 원시 응답 본문을 입력 편집기에 붙여넣습니다(정확한 바이트가 필요하면 터미널에서 먼저 pretty-print 하지 마세요).
- 오류 배너로 첫 불법 문자로 점프 — 흔히 후행 쉼표, 작은따옴표, 잘린 문자열입니다.
- 유효해지면 beautify하여 중첩 오류 객체/배열을 읽기 쉽게 합니다.
- 정리된 JSON을 fixture나 티켓 첨부로 API 소유자에게 전달합니다.
결과: 프로덕션 트래픽을 제3자 포맷터에 올리지 않고 수 초 안에 파싱 실패를 격리합니다.
사용 사례: 설정 JSON 정리
공유 appsettings / feature-flag JSON이 수동 편집 후 주석, 후행 쉼표, 불일치 들여쓰기가 쌓였습니다.
이 도구가 돕는 방법
- 설정을 붙여넣고 검증이 녹색이 될 때까지 모든 파싱 오류를 수정합니다.
- PR을 열기 전에 일관된 들여쓰기로 beautify합니다.
- 필요하면 컴팩트 설정 blob을 기대하는 환경용 복사본을 minify합니다.
- 줄 단위 리뷰가 필요하면 이전 리비전과 Text Diff로 비교합니다.
결과: 프로덕션 트래픽을 제3자 포맷터에 올리지 않고 수 초 안에 파싱 실패를 격리합니다.
사용 사례: 전송용 JSON minify
값을 바꾸지 않고 JSON 클레임 세트, webhook 본문, 큐 메시지를 한 줄 전송에 임베드해야 합니다.
이 도구가 돕는 방법
- 소스 객체를 검증해 minify가 구문 오류를 숨기지 않게 합니다.
- Minify를 클릭해 불필요한 공백을 제거합니다.
- 한 줄을 헤더, 환경 변수, 메시지 본문에 복사합니다.
- 나중에 다시 편집할 beautify 복사본을 로컬 기록에 둡니다.
결과: 프로덕션 트래픽을 제3자 포맷터에 올리지 않고 수 초 안에 파싱 실패를 격리합니다.
구문 함정 — JS 리터럴 vs 엄격한 JSON
엄격한 JSON은 JavaScript가 아닙니다. JS 콘솔에서는 괜찮아 보이는 입력을 파서가 거부할 때 이 간결한 표를 사용하세요.
흔한 JSON 구문 함정
| 항목 | Valid | Invalid | 함정 |
|---|---|---|---|
| 문자열 | "hello world" | 'hello world' | JSON은 큰따옴표가 필요합니다. 작은따옴표는 무효입니다. |
| 후행 쉼표 | ["a", "b", "c"] | ["a", "b", "c",] | ] 또는 } 앞에 후행 쉼표 없음. |
| 객체 키 | { "id": 1 } | { id: 1 } | 모든 키는 큰따옴표 문자열이어야 합니다. |
| 숫자 | 42, -3.14, 1.5e10 | 01, 007 | 선행 0은 허용되지 않습니다. |
| 주석 | (not allowed) | // note or /* */ | JSON에는 주석이 없습니다 — 파싱 전 제거. |
| Undefined / NaN | null | undefined, NaN | null만 JSON null 리터럴입니다. |
수정: 흔한 JSON 파싱 오류
텍스트가 ECMA-404를 위반하면 배너에 "잘못된 JSON — 입력을 파싱할 수 없습니다."이 표시됩니다.
발생 이유
파서는 첫 구문 위반에서 멈춥니다. 괄호 불일치, 작은따옴표 문자열, 후행 쉼표, 따옴표 없는 키, 주석, 비 JSON 리터럴 등.
진단
배너의 오류 줄을 클릭해 문제 문자로 점프합니다. 그 위치를 구문 함정 표와 비교 — 대부분의 실패는 여섯 행 중 하나입니다.
수정
- 문자열과 키의 작은따옴표를 큰따옴표로 교체.
- ]와 } 앞의 후행 쉼표 제거.
- 모든 객체 키에 따옴표. JavaScript 스타일 식별자 제거.
- // 및 /* */ 주석 제거. undefined/NaN을 null로 변환하거나 속성 생략.
- 괄호와 중괄호 균형. 로그 절단으로 잘린 문자열 복구.
첫 오류를 고친 뒤 재검증 — 문서 아래쪽에 두 번째 오류가 나타날 수 있습니다.
대용량 JSON 문서 다루기
서버 측 파일 크기 상한은 없습니다. 수 메가바이트 문서(20–30 MB+)는 편집기 캔버스용 브라우저 메모리가 충분하면 로컬에서 파싱됩니다.
- 검증만 필요하면 Minify 우선 — 작은 DOM 텍스트가 전체 beautify 트리보다 빠르게 느껴질 수 있습니다.
- 중첩 경로 하나만 필요하면 전체 문서 beautify 대신 트리 + 검색을 사용.
- 매우 큰 파일은 메인 스레드를 느리게 할 수 있음 — UI가 느려지면 최상위 키로 오프라인 분할.
- 기록 스냅샷도 localStorage 할당량 소비 — 큰 붙여넣기 후 오래된 항목 삭제.
포맷된 JSON을 다른 도구로 파이프
검증 후 제3 앱을 거치지 않고 DevUtilities 형제 도구로 출력을 파이프합니다.
- JSON to CSV — 루트가 동종 객체 배열일 때
- YAML ↔ JSON — YAML보내기가 필요한 Kubernetes/CI 매니페스트용
- Text Diff — 같은 페이로드의 두 리비전 비교
- JSON Generator — mock 스키마 설계 후 샘플을 여기서 포맷
- LLM Token Counter — minify 후 도구 스키마의 토큰 비용 측정
개인정보 — 페이로드는 브라우저에 유지
검증, beautify, minify, URL 인코딩 도우미, 트리 탐색, diff 비교는 모두 로컬 브라우저 메모리에서 실행됩니다.
- 입력은 외부 서버로 전송·저장·로깅되지 않습니다.
- 선택적 기록은 기기의 localStorage만 사용.
- 독점 API 페이로드, 설정 비밀, 프로덕션 덤프에 안전 — 공유 브라우저 프로필에 비밀을 남기지 마세요.
- 민감한 세션 후에는 비공개 창을 쓰거나 localStorage를 지우세요.
JSON 포맷팅 모범 사례
- minify 전에 검증해 잘못된 컴팩트 문자열을 배포하지 마세요.
- 사람용 beautify, 기계용 minify — 전송 문제 디버깅 시 둘 다 보관.
- JavaScript 객체 리터럴은 다른 언어로 취급하고 의도적으로 변환.
- 첫 오류로 점프, 수정, 재검증 — 1만 줄 붙여넣기를 맹목적으로 찾지 마세요.
- 채팅·이메일로 다시 붙이지 말고 정리된 JSON을 다음 도구로 파이프.
- 프로덕션 비밀 작업 후 로컬 기록 삭제.
자주 묻는 질문
일반적인 문제와 데이터 프라이버시에 대한 답변입니다.
공식 문서 및 참고 자료
이 유틸리티의 공식 사양 및 플랫폼 문서입니다.