JSON 파일 여는 법 — 트리로 보기와 문법 오류 찾기
2026년 10월 10일 작성
앱 설정을 백업한 파일, 데이터 내려받기 결과, 개발자가 보내 준 응답 예시가 .json으로 끝납니다. 메모장으로 열면 한 줄에 끝없이 이어진 괄호와 따옴표가 보여 어디서부터 읽어야 할지 막막합니다. JSON의 구조를 읽는 요령과 오류를 찾는 방법을 정리했습니다.
DuckViewer에서 바로 열기
JSON을 접고 펼 수 있는 트리로 보여주고, 원문 탭에서는 들여쓰기한 전체 내용을 보여줍니다.
파일은 서버로 전송되지 않고 브라우저 안에서만 처리됩니다. 첫 화면에서 파일을 끌어다 놓거나 [파일 열기]를 누르세요.
JSON 파일이란
JSON은 JavaScript Object Notation의 줄임말입니다. 이름은 자바스크립트에서 왔지만 지금은 거의 모든 프로그래밍 언어가 읽고 쓰는 범용 데이터 형식으로, RFC 8259와 ECMA-404로 표준화되어 있습니다. 규칙은 몇 가지뿐입니다.
| 표기 | 뜻 | 예 |
|---|---|---|
| { } | 객체: "이름": 값 쌍의 묶음 | {"이름": "김예시", "나이": 30} |
| [ ] | 배열: 순서 있는 값의 목록 | ["hwp", "pdf", "xlsx"] |
| "…" | 문자열(반드시 큰따옴표) | "DuckViewer" |
| 숫자 | 정수·소수 | 12000.5 |
| true / false / null | 참·거짓·값 없음 | true |
객체와 배열은 서로 얼마든지 겹쳐 넣을 수 있어서, 실제 파일은 여러 단계로 중첩된 나무 구조가 됩니다. 그래서 JSON을 읽을 때는 맨 바깥에서부터 한 단계씩 펼쳐 보는 방식이 효과적입니다.
JSON 파일을 만나는 상황
- 웹 서비스나 앱에서 "내 데이터 내려받기"를 했을 때
- 프로그램·게임의 설정 파일, 웹 앱의 manifest 파일
- 지도 데이터(GeoJSON), 공공 데이터 포털의 API 응답
- 개발자와 협업할 때 주고받는 요청·응답 예시
JSON 파일을 여는 방법 비교
| 방법 | 설치 | 트리 보기 | 편집 | 특징 |
|---|---|---|---|---|
| 메모장·텍스트 편집기 | 기본 설치 | 없음 | 가능 | 한 줄로 압축된 파일은 읽기 어려움 |
| VS Code 등 코드 편집기 | 필요 | 접기 기능 | 가능 | 문법 오류 표시, 자동 정렬 |
| Firefox 등 브라우저에서 직접 열기 | 없음 | 브라우저마다 다름 | 불가 | 로컬 파일 열기 방법이 브라우저마다 다름 |
| 온라인 JSON 정리 사이트 | 없음 | 있음 | 일부 | 내용을 사이트에 붙여넣거나 올려야 함 |
| DuckViewer | 없음 | 있음 | 가능 | 업로드 없이 트리·원문 보기와 오류 안내, 고치는 동안 문법 검사 |
내려받은 개인 데이터나 회사 API 응답에는 이름, 연락처, 접속 토큰 같은 민감한 정보가 들어 있는 경우가 많습니다. 온라인 정리 사이트에 붙여넣기 전에 한 번 더 생각해 보세요.
DuckViewer로 JSON 파일 여는 순서
- duckviewer.com에 접속합니다.
- .json 파일을 끌어다 놓거나 [파일 열기]로 선택합니다. 확장자가 없거나 낯선 파일도 내용이 JSON이면 인식합니다.
- [트리] 탭에서 ▶ 표시를 눌러 항목을 펼치고 접습니다. 처음에는 두 단계까지 펼쳐져 있습니다.
- [원문] 탭에서는 들여쓰기를 맞춘 전체 내용을 볼 수 있고, [모두 펼치기]로 트리를 한꺼번에 펼칠 수 있습니다.
보이는 것과 보이지 않는 것
- 문자열·숫자·참거짓·null을 서로 다른 색으로 표시하고, 객체와 배열에는 항목 수를 붙입니다.
- 배열이나 객체의 항목이 많으면 500개씩 보여주고 "나머지 N개 더 보기"로 이어서 펼칩니다.
- [모두 펼치기]는 브라우저가 멈추지 않도록 한 번에 2,000개 항목까지만 펼칩니다.
- UTF-8과 EUC-KR 인코딩을 자동으로 판별해 한글이 깨지지 않게 보여줍니다.
- [편집]을 누르면 원문을 고칠 수 있습니다. 문법을 바로 검사하고, [들여쓰기 정리]로 모양을 맞추며, 오류가 남아 있으면 저장하지 않습니다.
- 검색 기능은 없습니다. 특정 값을 찾으려면 [원문] 탭에서 브라우저의 찾기(Ctrl+F)를 쓰세요.
자주 나는 JSON 문법 오류
JSON은 규칙이 엄격해서 쉼표 하나만 잘못돼도 파일 전체를 읽을 수 없습니다. DuckViewer는 문법 오류가 있으면 트리 대신 원문을 보여주고, 브라우저가 알려 주는 오류 메시지를 함께 표시합니다. 크롬 계열 브라우저에서는 메시지에 오류가 난 위치(몇 번째 글자 또는 줄)가 들어 있으니 원문에서 그 부근을 살펴보세요. 흔한 원인은 다음과 같습니다.
- 마지막 항목 뒤의 쉼표 —
[1, 2, 3,]처럼 끝에 쉼표가 남은 경우 - 작은따옴표 — 문자열과 이름은 반드시 큰따옴표(")로 감싸야 합니다.
- 따옴표 없는 이름 —
{name: "a"}가 아니라{"name": "a"} - 주석 — 표준 JSON에는 // 나 /* */ 주석이 없습니다. 설정 파일 중에는 주석을 허용하는 변형(JSONC)도 있습니다.
- 여러 JSON이 줄마다 이어진 파일 — 한 줄에 하나씩 객체가 있는 JSON Lines(.jsonl) 형식은 파일 전체로는 JSON이 아닙니다.
낯선 JSON을 빠르게 파악하는 요령
처음 보는 JSON은 맨 바깥 구조부터 확인합니다. 바깥이 배열이면 "같은 모양의 기록이 여러 개"인 경우가 많으니, 첫 항목 하나만 펼쳐서 어떤 이름들이 있는지 보면 전체 구조를 짐작할 수 있습니다. 바깥이 객체라면 "data", "items", "results"처럼 실제 내용이 담긴 이름과 "meta", "status" 같은 부가 정보를 구분해 보세요. DuckViewer의 트리는 배열과 객체 옆에 항목 수를 표시하므로, 어디에 데이터가 몰려 있는지 펼치기 전에 가늠할 수 있습니다.
자주 묻는 질문
트리 대신 원문과 오류 메시지만 나옵니다.
파일에 JSON 문법 오류가 있는 경우입니다. 오류 메시지에 표시된 위치 부근에서 마지막 항목 뒤의 쉼표, 작은따옴표, 따옴표 없는 이름, 주석이 있는지 확인하세요. 한 줄에 객체가 하나씩 있는 JSON Lines 파일도 오류로 표시됩니다.
JSON 내용을 고쳐서 저장할 수 있나요?
네. [편집]을 누르면 원문을 직접 고칠 수 있고, 고치는 동안 문법이 맞는지 바로 검사합니다. [들여쓰기 정리]로 모양을 맞출 수 있으며, 문법 오류가 남아 있으면 저장하지 않습니다. 오류를 고친 뒤 [저장]을 누르면 JSON 파일로 내려받아집니다.
수십 MB짜리 JSON도 열 수 있나요?
열 수 있지만 브라우저 메모리를 많이 사용합니다. DuckViewer는 처음에 두 단계까지만 그리고 나머지는 펼칠 때 만들어 부담을 줄이지만, 아주 큰 파일은 컴퓨터 성능에 따라 느려질 수 있습니다.
JSON 안의 개인정보가 외부로 전송되지 않나요?
JSON 파일을 읽고 트리로 그리는 과정은 모두 브라우저 안에서 처리되며 파일이 서버로 업로드되지 않습니다.