JSON은 웹에서 가장 흔한 데이터 형식입니다. API 응답, 설정 파일, 로그 데이터까지 거의 모든 개발 흐름에서 보게 되지만, 한 줄로 압축된 JSON은 구조를 파악하기 어렵고 작은 실수도 찾기 힘듭니다.
왜 포맷팅이 먼저일까요?
포맷팅은 보기 좋게 만드는 작업이기도 하지만, 오류를 찾기 쉽게 만드는 작업이기도 합니다. 들여쓰기가 정리된 JSON은 중첩 구조, 배열, 누락된 쉼표를 훨씬 빠르게 확인할 수 있습니다.
자주 나는 오류
| 문제 | 예시 | 해결 방법 |
|---|---|---|
| 마지막 쉼표 | {"a": 1,} | 마지막 쉼표 제거 |
| 작은따옴표 사용 | {'a': 1} | 큰따옴표로 변경 |
| 키 따옴표 누락 | {a: 1} | "a"처럼 감싸기 |
| 항목 사이 쉼표 누락 | {"a": 1 "b": 2} | 항목 사이 쉼표 추가 |
빠르게 확인하는 순서
- JSON 원문을 JSON YAML 변환에 붙여 넣습니다.
- 구조가 깨졌는지 먼저 확인합니다.
- 필요하면 YAML로 한 번 바꿔 구조를 읽기 쉽게 본 뒤 다시 JSON으로 돌립니다.
- 정리된 결과를 복사해 API 요청이나 설정 파일에 다시 사용합니다.
YAML과 같이 볼 때 좋은 이유
YAML은 사람이 읽기 쉬워 구조 점검에 유리하고, JSON은 데이터 교환에 안정적입니다. 복잡한 설정값이나 긴 응답 본문은 두 형식을 오가며 확인하면 이해가 더 빨라집니다.
실무 팁
- 문제를 찾기 전에 먼저 보기 좋게 정리하세요.
- API로 보내기 전에 반드시 한 번 검증하세요.
- 개행 문자나 특수문자 이스케이프도 같이 확인하세요.
- 결과가 비슷해 보여도 텍스트 비교로 비교하면 작은 차이를 빨리 찾을 수 있습니다.
JSON을 잘 다루는 가장 쉬운 방법은 암기보다 흐름입니다. 먼저 정리하고, 구조를 확인하고, 그다음에 실제 요청이나 배포에 넣는 습관만 있어도 디버깅 시간이 크게 줄어듭니다.