JSON 파일 여는 법 — 브라우저에서 보기 좋게 정리하고 오류 위치까지 찾기 (윈도우, 설치 없이)
앱에서 내 데이터를 내려받았더니, 또는 프로그램 폴더에 설정 파일이 있는데 확장자가 .json 입니다. 더블클릭하면 어떤 앱으로 열지 묻거나, 괄호와 따옴표가 끝없이 이어진 한 줄이 나옵니다. JSON 은 그냥 글자 파일이라 PC 에 있는 브라우저로 열고 체크 한 번이면 읽을 수 있게 정리됩니다. 윈도우에서 되는 방법들을 실제 파일로 해 본 결과와, 파일이 깨져 있을 때 각 방법이 어떻게 반응하는지 정리했습니다.
.json 파일을 붙여넣거나 끌어다 놓으면 줄을 맞춰 정리하고, 한 줄로 압축하고, 트리로 펼쳐 보고, 문법 오류의 줄·칸 위치를 알려 줍니다. 브라우저 안에서만 처리해 JSON 을 어디로도 보내지 않습니다.
- ✓ 무료
- ✓ 설치·회원가입 없음
- ✓ 브라우저에서 바로 실행
- ✓ 파일이 서버로 올라가지 않음
🔒 파일을 서버나 다른 어떤 곳으로도 보내지 않습니다 — 내 컴퓨터의 브라우저 안에서만 처리합니다.
JSON 파일이 뭐길래 한 줄로 붙어 있나
JSON 은 데이터를 글자로 적는 형식입니다. 이름은 큰따옴표 안에, 값은 콜론 뒤에, 묶음은 중괄호 { } 로, 목록은 대괄호 [ ] 로 씁니다. 앱 설정, 서비스에서 내려받은 내 데이터, 프로그램끼리 주고받는 내용에 두루 쓰입니다. 글자일 뿐이라 .json 파일은 열기만 해서는 아무것도 실행되지 않습니다. 메모장이나 브라우저로 여는 건 안전합니다.
윈도우에서 불편한 점은 두 가지입니다. 첫째, 열 프로그램이 정해져 있지 않을 수 있습니다. 제 윈도우 11 Home PC 에서 assoc .json 을 실행하면 아무것도 나오지 않았고 기본 앱도 없어서, 더블클릭하면 어떤 앱으로 열지 묻습니다. 둘째, 프로그램은 보통 공백과 줄바꿈을 다 빼고 저장합니다. 시험에 쓴 주문 내역 파일(주문 6건, 키 74개, 5단계로 겹친 구조)은 1,175바이트가 한 줄이었습니다. 2칸 들여쓰기로 정리하면 116줄 · 2,156바이트, 4칸이면 2,948바이트입니다. 공백은 사람이 읽을 때만 필요하니 프로그램은 빼고 저장하는 겁니다.
방법 1: 엣지·크롬에서 열고 pretty print 켜기
- 1.json 파일을 열려 있는 엣지나 크롬 창에 끌어다 놓습니다. (또는 파일을 오른쪽 클릭 → 연결 프로그램 → Microsoft Edge)
- 2저장된 그대로, 보통 한 줄짜리 글자가 나옵니다.
- 3페이지 맨 위 막대의 체크박스를 켭니다. 크롬은 'pretty print 적용', 엣지는 '예쁜 인쇄'라고 적혀 있습니다.
윈도우 11 의 엣지 154 · 크롬 154 로 해 봤습니다. 두 브라우저 모두 글자 위에 체크박스가 있고, 켜면 2칸 들여쓰기로 다시 정리돼 위의 116줄짜리와 같은 모양이 됩니다. 설치할 것도 없고 파일은 내 PC 에 그대로 있습니다.
체크박스는 브라우저가 보통 창으로 파일을 열었을 때 나왔습니다. 같은 브라우저를 창 없는 모드(헤드리스, 자동화 도구가 쓰는 방식)로 돌렸을 때는 막대가 없고 원래 글자만 보였습니다.
문제는 파일이 깨져 있을 때입니다. 닫는 괄호 앞에 쉼표를 하나 더 넣어("push":false,}) 일부러 틀린 JSON 을 만들었습니다. 두 브라우저 모두 체크박스는 그대로 보였지만 눌러도 아무 일도 일어나지 않았습니다. 한 줄 그대로였고 왜 그런지 알려 주는 말도 없었습니다. 체크박스를 켰는데 정리되지 않는다면, 파일이 깨졌다는 뜻이지만 어디가 깨졌는지는 브라우저가 알려 주지 않습니다.
방법 2: 어디가 틀렸는지 알려 주는 JSON 포매터
JSON 포매터는 브라우저 체크박스가 하는 일에 더해 문법 검사도 합니다. 깨진 파일을 이 사이트의 JSON 포매터에 붙여넣고 Format 을 눌렀더니 Line 1, Col 1102: Expected double-quoted property name in JSON 이라고 나오고, 그 줄을 보여 주면서 쉼표 바로 아래에 ^ 표시를 붙였습니다. 파이썬도 같은 자리(1102번째 칸)를 가리켰습니다.
쉼표를 지우고 다시 누르니 정리된 결과와 함께 입력 1.1 KB · 출력 2.1 KB · 키 74개 · 깊이 5 가 나왔습니다. Minify 는 반대로 다시 한 줄로 압축하고, 트리 보기로 바꾸면 주문 목록을 접었다 펴면서 한 건씩 볼 수 있습니다. 붙여넣는 대신 .json 파일을 입력 칸에 끌어다 놓아도 됩니다.
온라인 포매터 중에는 붙여넣은 내용을 서버로 보내는 곳이 많습니다. 이 도구는 페이지 안에서 처리합니다. 쓰는 동안 네트워크 기록을 확인해 보니 요청은 페이지를 불러올 때 1건뿐이었고, 정리·검사를 세 번 하는 동안 추가 요청은 없었습니다. 제 시험 파일처럼 이름·이메일·주문 내역이 들어 있는 데이터라면 이 차이가 중요합니다.
방법 3: 메모장 — 잠깐 보거나 값 하나 고칠 때
메모장으로도 .json 파일은 열립니다. 설정 파일에서 값 하나만 바꿀 때는 메모장이면 충분합니다. 다만 정리도 검사도 하지 않아서 한 줄짜리는 한 줄 그대로이고, 따옴표 하나가 빠져도 알려 주지 않습니다. 메모장으로 고쳤다면 UTF-8 로 저장하고, 브라우저나 포매터로 한 번 열어 확인하세요. 브라우저에서 pretty print 가 그대로 되면 아직 올바른 JSON 입니다.
방법 4: VS Code
Visual Studio Code 가 이미 있다면 JSON 을 읽고 고치기에 가장 편합니다. 공식 문서에 따르면 윈도우에서는 Shift+Alt+F, 또는 오른쪽 클릭 메뉴의 '문서 서식(Format Document)'으로 정리됩니다. 문법에 색을 입히고 묶음을 접었다 펼 수도 있습니다. settings.json 같은 VS Code 설정 파일은 'JSON with Comments' 로 취급돼 주석과 마지막 쉼표를 허용하지만, 다른 프로그램이 읽는 일반 .json 파일에는 둘 다 있으면 안 됩니다.
방법 5: 명령어 — 그리고 발목 잡는 기본값 두 가지
파이썬에는 JSON 정리 기능이 들어 있습니다. 파일 이름을 주면 4칸 들여쓰기로 출력합니다.
python -m json.tool --no-ensure-ascii data.json--no-ensure-ascii 를 빼면 한글이 전부 기호로 바뀝니다. 제 파일의 '김민수'가 \uae40\ubbfc\uc218 로 나왔습니다. 데이터는 같지만 읽을 수가 없습니다. 깨진 파일에서는 Expecting property name enclosed in double quotes: line 1 column 1102 (char 1101) 라고 정확한 위치를 알려 주며 멈췄습니다.
윈도우에 기본으로 들어 있는 Windows PowerShell 5.1 도 JSON 을 읽지만, 다시 쓸 때 함정이 있습니다. ConvertFrom-Json 으로 읽고 ConvertTo-Json 으로 다시 썼더니, 기본 설정에서는 주문마다 들어 있던 상품 목록(items)이 빈 문자열이 됐습니다. 상품 정보가 사라졌는데 오류는 없었습니다. -Depth 10 을 붙이니 전부 남았습니다.
Get-Content data.json -Raw -Encoding UTF8 | ConvertFrom-Json | ConvertTo-Json -Depth 10깨진 파일에 대해 PowerShell 5.1 의 ConvertFrom-Json 은 Invalid JSON primitive: . 라고만 하고 줄·칸을 알려 주지 않았습니다. 오류 위치를 찾는 데는 가장 도움이 안 되는 방법입니다.
어떤 방법을 쓸까
| 방법 | 설치 | 줄 맞춤 | 오류 찾기 | 실측 메모 |
|---|---|---|---|---|
| 엣지·크롬 pretty print | 없음 | 2칸 | 안 됨 — 조용함 | 깨진 파일이면 체크해도 그대로 |
| JSON 포매터(브라우저) | 없음 | 2·4칸·탭 | 줄·칸 표시 | 정리 중 네트워크 요청 0건 |
| 메모장 | 없음 | 안 됨 | 안 됨 | 값 하나 고칠 때 |
| VS Code | 필요 | Shift+Alt+F | 됨 | 설정 파일은 주석 허용 |
| python -m json.tool | 파이썬 | 4칸 | 줄·칸 표시 | 한글은 --no-ensure-ascii |
| PowerShell 5.1 | 없음 | 됨 | 위치 없음 | -Depth 10 안 쓰면 안쪽 데이터 손실 |
그냥 읽기만 하려면 브라우저에 끌어다 놓으세요. 정리가 안 되거나 프로그램이 'JSON 이 잘못됐다'고 하면 포매터에 붙여넣어 줄·칸을 확인합니다. JSON 을 매일 다룬다면 VS Code 를 설치할 만합니다.
자주 묻는 질문
Q. JSON 파일을 열어도 안전한가요?
네. .json 파일은 글자 파일이라 메모장·브라우저·포매터로 열면 보여 주기만 합니다. 연다고 코드가 실행되지 않습니다. 다만 개인 정보가 들어 있다면 붙여넣을 곳은 가려야 합니다 — 업로드하지 않는 도구를 쓰세요.
Q. JSON 파일이 왜 한 줄로 길게 보이나요?
프로그램은 사람이 읽을 때만 필요한 공백과 줄바꿈을 빼고 저장합니다. 제 시험 파일은 1,175바이트가 한 줄이었고, 2칸 들여쓰기로 정리하니 116줄 · 2,156바이트였습니다. 엣지·크롬의 체크박스나 포매터의 Format 으로 다시 넣어 읽으면 됩니다.
Q. .json 파일을 항상 같은 앱으로 열리게 하려면?
.json 파일을 오른쪽 클릭 → 연결 프로그램 → 다른 앱 선택에서 앱(예: Microsoft Edge, 메모장)을 고르고 '항상'을 누릅니다. 그다음부터는 더블클릭하면 그 앱으로 열립니다.
Q. 브라우저에서 pretty print 를 켜도 그대로예요.
제 시험에서는 파일이 올바른 JSON 이 아닐 때 그랬습니다 — 쉼표 하나로 충분했습니다. 브라우저는 오류를 알려 주지 않으니 JSON 포매터에 붙여넣거나 python -m json.tool 로 열어 줄·칸을 확인하세요.
Q. 'Expected double-quoted property name' 은 무슨 뜻인가요?
큰따옴표로 감싼 이름이 와야 할 자리에 다른 것이 있다는 뜻입니다. 닫는 괄호 앞의 쉼표, 따옴표 없이 쓴 이름이 가장 흔합니다. 함께 나오는 칸 번호가 그 자리입니다.
.json 파일을 붙여넣거나 끌어다 놓으면 줄을 맞춰 정리하고, 한 줄로 압축하고, 트리로 펼쳐 보고, 문법 오류의 줄·칸 위치를 알려 줍니다. 브라우저 안에서만 처리해 JSON 을 어디로도 보내지 않습니다.
- ✓ 무료
- ✓ 설치·회원가입 없음
- ✓ 브라우저에서 바로 실행
- ✓ 파일이 서버로 올라가지 않음
🔒 파일을 서버나 다른 어떤 곳으로도 보내지 않습니다 — 내 컴퓨터의 브라우저 안에서만 처리합니다.