JSON 파일 여는 법 — 트리로 보기와 문법 오류 찾기

2026년 10월 10일 작성

앱 설정을 백업한 파일, 데이터 내려받기 결과, 개발자가 보내 준 응답 예시가 .json으로 끝납니다. 메모장으로 열면 한 줄에 끝없이 이어진 괄호와 따옴표가 보여 어디서부터 읽어야 할지 막막합니다. JSON의 구조를 읽는 요령과 오류를 찾는 방법을 정리했습니다.

한눈에 보기 JSON(JavaScript Object Notation)은 이름과 값의 쌍, 목록을 중괄호와 대괄호로 표현하는 데이터 형식으로, 웹 API와 설정 파일에 널리 쓰입니다. 텍스트 편집기, 코드 편집기, 브라우저로 열 수 있습니다. DuckViewer(duckviewer.com)에서는 설치·업로드 없이 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 파일을 만나는 상황

JSON 파일을 여는 방법 비교

방법설치트리 보기편집특징
메모장·텍스트 편집기기본 설치없음가능한 줄로 압축된 파일은 읽기 어려움
VS Code 등 코드 편집기필요접기 기능가능문법 오류 표시, 자동 정렬
Firefox 등 브라우저에서 직접 열기없음브라우저마다 다름불가로컬 파일 열기 방법이 브라우저마다 다름
온라인 JSON 정리 사이트없음있음일부내용을 사이트에 붙여넣거나 올려야 함
DuckViewer없음있음가능업로드 없이 트리·원문 보기와 오류 안내, 고치는 동안 문법 검사

내려받은 개인 데이터나 회사 API 응답에는 이름, 연락처, 접속 토큰 같은 민감한 정보가 들어 있는 경우가 많습니다. 온라인 정리 사이트에 붙여넣기 전에 한 번 더 생각해 보세요.

DuckViewer로 JSON 파일 여는 순서

  1. duckviewer.com에 접속합니다.
  2. .json 파일을 끌어다 놓거나 [파일 열기]로 선택합니다. 확장자가 없거나 낯선 파일도 내용이 JSON이면 인식합니다.
  3. [트리] 탭에서 ▶ 표시를 눌러 항목을 펼치고 접습니다. 처음에는 두 단계까지 펼쳐져 있습니다.
  4. [원문] 탭에서는 들여쓰기를 맞춘 전체 내용을 볼 수 있고, [모두 펼치기]로 트리를 한꺼번에 펼칠 수 있습니다.

보이는 것과 보이지 않는 것

자주 나는 JSON 문법 오류

JSON은 규칙이 엄격해서 쉼표 하나만 잘못돼도 파일 전체를 읽을 수 없습니다. DuckViewer는 문법 오류가 있으면 트리 대신 원문을 보여주고, 브라우저가 알려 주는 오류 메시지를 함께 표시합니다. 크롬 계열 브라우저에서는 메시지에 오류가 난 위치(몇 번째 글자 또는 줄)가 들어 있으니 원문에서 그 부근을 살펴보세요. 흔한 원인은 다음과 같습니다.

낯선 JSON을 빠르게 파악하는 요령

처음 보는 JSON은 맨 바깥 구조부터 확인합니다. 바깥이 배열이면 "같은 모양의 기록이 여러 개"인 경우가 많으니, 첫 항목 하나만 펼쳐서 어떤 이름들이 있는지 보면 전체 구조를 짐작할 수 있습니다. 바깥이 객체라면 "data", "items", "results"처럼 실제 내용이 담긴 이름과 "meta", "status" 같은 부가 정보를 구분해 보세요. DuckViewer의 트리는 배열과 객체 옆에 항목 수를 표시하므로, 어디에 데이터가 몰려 있는지 펼치기 전에 가늠할 수 있습니다.

자주 묻는 질문

트리 대신 원문과 오류 메시지만 나옵니다.

파일에 JSON 문법 오류가 있는 경우입니다. 오류 메시지에 표시된 위치 부근에서 마지막 항목 뒤의 쉼표, 작은따옴표, 따옴표 없는 이름, 주석이 있는지 확인하세요. 한 줄에 객체가 하나씩 있는 JSON Lines 파일도 오류로 표시됩니다.

JSON 내용을 고쳐서 저장할 수 있나요?

네. [편집]을 누르면 원문을 직접 고칠 수 있고, 고치는 동안 문법이 맞는지 바로 검사합니다. [들여쓰기 정리]로 모양을 맞출 수 있으며, 문법 오류가 남아 있으면 저장하지 않습니다. 오류를 고친 뒤 [저장]을 누르면 JSON 파일로 내려받아집니다.

수십 MB짜리 JSON도 열 수 있나요?

열 수 있지만 브라우저 메모리를 많이 사용합니다. DuckViewer는 처음에 두 단계까지만 그리고 나머지는 펼칠 때 만들어 부담을 줄이지만, 아주 큰 파일은 컴퓨터 성능에 따라 느려질 수 있습니다.

JSON 안의 개인정보가 외부로 전송되지 않나요?

JSON 파일을 읽고 트리로 그리는 과정은 모두 브라우저 안에서 처리되며 파일이 서버로 업로드되지 않습니다.

함께 읽으면 좋은 글