JSON 포맷 정리 도구 총정리 - 한 줄짜리 데이터를 3초 만에 읽기 좋게 만드는 방법
한 줄로 뭉쳐진 JSON 때문에 눈이 아프신가요? 온라인 포맷터부터 에디터 내장 기능, CLI 도구까지 상황별로 가장 빠른 JSON 정리 방법을 실무 기준으로 정리했습니다.
API 응답을 확인하려고 열었는데 수천 글자가 한 줄로 붙어 있는 JSON을 마주한 경험, 개발이나 데이터 작업을 해본 분이라면 누구나 있을 겁니다. 중괄호가 어디서 열리고 닫히는지 눈으로 따라가다 보면 5분이 그냥 사라집니다. JSON 포맷 정리 도구를 제대로 알고 있으면 이 시간을 3초로 줄일 수 있습니다. 이 글에서는 상황별로 어떤 도구를 쓰는 것이 가장 빠른지, 실무 기준으로 정리합니다.
JSON 포맷 정리가 필요한 순간
서버는 전송 용량을 아끼기 위해 JSON을 공백 없이 압축(minify)해서 내려주는 경우가 많습니다. 기계에게는 아무 문제가 없지만 사람에게는 고문에 가깝습니다. 특히 아래 상황에서 포맷 정리가 필수입니다.
- API 디버깅: 응답 구조를 파악해야 하는데 중첩 깊이가 3단계만 넘어가도 눈으로 추적이 불가능합니다
- 로그 분석: 서버 로그에 찍힌 JSON 한 줄에서 특정 필드 값을 찾아야 할 때
- 설정 파일 수정: 쉼표 하나, 따옴표 하나 빠진 것 때문에 서비스가 안 뜨는 경우
- 데이터 검증: 문법 오류가 어디 있는지 위치를 정확히 찾아야 할 때
JSON 포맷 정리는 단순한 미관 문제가 아니라 디버깅 속도의 문제입니다. 구조가 눈에 보이는 순간 문제의 절반은 이미 해결된 것과 같습니다.
JSON 포맷 정리 도구의 종류와 특징
온라인 웹 도구
브라우저에서 붙여넣기만 하면 되는 방식입니다. JSONLint 같은 서비스는 포맷 정리와 함께 문법 검증(validation)까지 해주기 때문에, 오류가 있는 줄 번호를 바로 알려줍니다. 설치가 필요 없어서 가장 진입 장벽이 낮습니다.
에디터 내장 기능
VS Code는 문서 포맷 기능(Windows 기준 Shift+Alt+F)으로 JSON 파일을 즉시 정리할 수 있습니다. 파일로 저장해서 작업하는 경우라면 별도 도구 없이 이 방법이 가장 빠릅니다. 브라우저 개발자 도구의 네트워크 탭도 JSON 응답을 자동으로 트리 형태로 보여줍니다.
CLI 도구
터미널에서 작업한다면 jq가 표준에 가깝습니다. curl 결과를 파이프로 넘겨서 | jq . 한 번이면 정리와 색상 하이라이팅까지 끝납니다. 파이썬이 설치되어 있다면 python3 -m json.tool도 추가 설치 없이 쓸 수 있습니다.
상황별 도구 비교
| 도구 유형 | 대표 도구 | 장점 | 적합한 상황 |
|---|---|---|---|
| 온라인 도구 | JSONLint 등 | 설치 불필요, 문법 검증 포함 | 일회성 확인, 비개발자 |
| 에디터 내장 | VS Code 포맷 기능 | 파일 작업과 통합, 오프라인 가능 | 설정 파일 수정, 반복 작업 |
| CLI | jq, python -m json.tool | 자동화 가능, 파이프 연계 | 서버 작업, 스크립트 처리 |
| 브라우저 개발자 도구 | Chrome DevTools | API 응답 자동 트리 표시 | 웹 API 디버깅 |
JSON.stringify(obj, null, 2) 한 줄로 들여쓰기 2칸짜리 정리된 문자열을 만들 수 있습니다. 콘솔에서 즉석으로 확인할 때 유용합니다.실무에서 바로 쓰는 활용 팁
도구를 아는 것과 잘 쓰는 것은 다릅니다. 실제 작업 흐름에서 시간을 아껴주는 방법 몇 가지를 소개합니다.
- 정리 후 검증까지 한 번에: 포맷 정리 도구 중 검증 기능이 있는 것을 기본으로 쓰세요. 어차피 오류 찾기가 목적인 경우가 대부분입니다
- 정렬 옵션 활용: 키를 알파벳순으로 정렬하면 두 JSON을 비교(diff)할 때 훨씬 수월합니다. jq는
-S옵션으로 지원합니다 - 정규식과 조합: 정리된 JSON 로그에서 특정 패턴의 값만 뽑아야 할 때는 정규식이 필요합니다. 패턴을 작성하기 전에 정규식 테스터에서 샘플 데이터로 미리 검증하면 시행착오를 크게 줄일 수 있습니다
자주 하는 실수와 보안 주의사항
민감한 데이터를 온라인 도구에 붙여넣기
가장 흔하면서도 위험한 실수입니다. 액세스 토큰, 개인정보, 내부 시스템 정보가 포함된 JSON을 외부 웹 도구에 붙여넣는 순간 데이터가 외부 서버로 전송될 수 있습니다. 민감한 데이터는 반드시 로컬 도구(에디터, CLI)로 처리하는 것을 원칙으로 삼으세요.
JSON 문법 착각
JSON은 자바스크립트 객체 표기법과 비슷하지만 더 엄격합니다. 키를 반드시 큰따옴표로 감싸야 하고, 마지막 요소 뒤의 쉼표(trailing comma)를 허용하지 않으며, 주석도 쓸 수 없습니다. 손으로 수정한 설정 파일이 안 읽힌다면 대부분 이 세 가지 중 하나입니다.
인코딩 문제 간과
한글이 \uD55C\uAE00 형태의 유니코드 이스케이프로 표시되는 경우가 있습니다. 데이터 자체는 정상이니 당황할 필요 없습니다. jq는 기본적으로 이를 사람이 읽을 수 있는 형태로 출력해 줍니다.
오늘 바로 적용할 것
도구 목록을 아는 것보다 손에 익히는 것이 중요합니다. 두 가지만 오늘 해보세요.
첫째, 자신의 주 작업 환경에 맞는 기본 도구 하나를 정하세요. 에디터 중심이라면 VS Code 포맷 단축키를 외우고, 터미널 중심이라면 jq를 설치해서 | jq . 파이프를 습관으로 만드는 겁니다. 둘째, 민감한 데이터는 로컬에서만 처리한다는 원칙을 지금 팀 위키나 개인 메모에 적어두세요. 이 두 가지만으로도 JSON 때문에 낭비하던 시간이 눈에 띄게 줄어들 겁니다.
