JSON 텍스트 정렬·포맷팅 완벽 가이드
JSON 포맷팅, 들여쓰기, 미니파이, 유효성 검사 방법. API 응답, 설정 파일, 데이터 교환에서 JSON을 다루는 실무 완전 정리.
Q.JSON을 보기 좋게 정렬하는 방법은?
JSON 포맷팅 도구에 JSON 텍스트를 붙여넣으면 들여쓰기가 적용된 가독성 있는 형태로 자동 변환됩니다. 동시에 JSON 문법 유효성도 검사합니다.
API 응답을 받았는데 한 줄짜리 JSON이라 읽을 수가 없습니다. 설정 파일을 수정하려는데 어디서 어디까지가 한 블록인지 파악이 어렵습니다. JSON 포맷팅의 모든 것을 정리합니다.
JSON 기본 구조와 규칙
JSON(JavaScript Object Notation)은 ECMA-404 표준으로 정의된 경량 데이터 교환 형식입니다.
| 데이터 타입 | 예시 | 주의사항 |
|---|---|---|
| 문자열 | "텍스터브" | 반드시 큰따옴표 사용 |
| 숫자 | 42, 3.14 | 따옴표 없음 |
| 불리언 | true, false | 소문자 |
| null | null | 소문자 |
| 배열 | [1, 2, 3] | 대괄호 |
| 객체 | {"key": "value"} | 중괄호 |
포맷팅 vs 미니파이: 언제 어느 것을?
포맷팅 (Pretty Print)
json
{
"name": "텍스터브",
"tools": ["글자수 세기", "줄바꿈 정리"],
"active": true
}
- 들여쓰기(2 또는 4칸)로 가독성 향상
- 개발 중 디버깅, 코드 리뷰, 문서화에 적합
- 파일 용량이 미니파이 대비 20-40% 큼
미니파이 (Minify)
json
{"name":"텍스터브","tools":["글자수 세기","줄바꿈 정리"],"active":true}
- 공백·줄바꿈 제거로 파일 크기 최소화
- API 응답, 프로덕션 배포 설정 파일에 적합
- 가독성 낮음
데이터 기준으로: 일반적인 JSON 설정 파일의 미니파이 압축률은 15-30%입니다. gzip 압축이 적용된 환경에서는 미니파이 효과가 미미해집니다.
자주 발생하는 JSON 오류
| 오류 유형 | 원인 | 예시 |
|---|---|---|
| Unexpected token | 쉼표 누락·과잉 | {"a":1 "b":2} |
| Trailing comma | 마지막 항목 뒤 쉼표 | [1, 2, 3,] |
| 단따옴표 | JSON은 큰따옴표만 허용 | {'key': 'value'} |
| undefined | JSON 미지원 값 | {"val": undefined} |
| 주석 | JSON은 주석 미지원 | // 주석 |
JSON5는 주석·단따옴표·trailing comma를 허용하는 JSON 상위 집합이지만, 표준 JSON 파서에서는 오류가 발생합니다.
JSON 유효성 검사가 중요한 이유
API 연동, 설정 파일 배포, 데이터 파이프라인에서 잘못된 JSON은 시스템 장애를 유발합니다. 배포 전 유효성 검사가 필수입니다.
자주 묻는 질문
Q. JSON 들여쓰기는 2칸과 4칸 중 어느 것이 표준인가요?
ECMA-404 표준에 들여쓰기 규칙은 없습니다. 언어별 관행: JavaScript·TypeScript는 2칸, Java·C#은 4칸이 일반적입니다.
Q. JSON에 한글을 써도 되나요?
네. JSON은 UTF-8 인코딩을 지원합니다. "이름": "텍스터브"와 같이 한글 키·값 모두 사용 가능합니다.
Q. 큰 JSON 파일을 빠르게 탐색하는 방법은?
JSON 뷰어 도구를 사용하면 트리 구조로 시각화해 특정 키를 빠르게 찾을 수 있습니다.
---
텍스터브 JSON 포맷팅 도구에 JSON 텍스트를 붙여넣으면 들여쓰기 포맷팅, 미니파이, 유효성 검사를 즉시 수행합니다.
---
이 글은 AI 도구를 활용해 공개 자료를 정리·요약한 결과입니다. 중요한 사항은 공식 기관에서 직접 확인하세요.