JSON 파일 여는 방법과 편집하는 방법 (깨뜨리지 않고 안전하게)

JSON 파일을 더블클릭했더니 브라우저가 열리거나, 메모장에서 한 줄로 길게 늘어져 도무지 알아볼 수 없던 적 있으신가요.
"이걸 어떻게 보고 어떻게 고치라는 거지" 싶어 막막하셨다면, 도구를 잘못 골랐을 가능성이 큽니다. JSON은 어떤 프로그램으로 여느냐에 따라 난이도가 완전히 달라집니다.

오늘은 JSON을 보기 좋게 여는 법과, 망가뜨리지 않고 편집하는 법을 단계별로 정리하겠습니다.

 

목적에 맞는 도구 고르기

JSON은 보기만 할 때와 편집할 때 적합한 도구가 다릅니다.

하고 싶은 일	추천 도구
내용만 빠르게 확인	웹 브라우저, 온라인 뷰어
안전하게 편집	무료 코드 편집기(VS Code 등)
구조가 맞는지 검사	온라인 JSON 검사 도구

 

방법 1. 코드 편집기로 열기 (가장 추천)

편집까지 할 거라면 무료 코드 편집기가 가장 좋습니다. 줄을 자동 정렬해 구조를 보여 주고, 문법이 틀리면 색으로 짚어 줘서 실수를 바로 알 수 있습니다.

1. 무료 코드 편집기를 설치합니다.
2. JSON 파일을 편집기로 끌어다 놓습니다.
3. 한 줄로 뭉쳐 있다면 '코드 정렬(서식 지정)' 기능으로 보기 좋게 펼칩니다.

방법 2. 웹 브라우저로 내용만 확인하기

설치가 부담스럽고 그냥 내용만 보고 싶다면, JSON 파일을 브라우저 창으로 끌어다 놓으면 됩니다. 많은 브라우저가 JSON을 펼쳐서 보여 줍니다. 다만 이 방법은 보기 전용이라 편집에는 맞지 않습니다.

---

편집할 때 꼭 지킬 규칙

JSON은 문법에 예민해서, 사소한 실수 하나로 전체가 오류가 됩니다. 아래 세 가지만 지켜도 대부분의 사고를 막을 수 있습니다.

{
  "이름": "김민수",
  "나이": 29
}

첫째, 글자 값은 반드시 큰따옴표로 감쌉니다. 둘째, 마지막 항목 뒤에는 쉼표를 붙이지 않습니다. 셋째, 중괄호와 대괄호의 짝을 맞춥니다. 위 예시에서 29 뒤에 쉼표를 넣으면 바로 오류가 납니다.

편집 전 백업은 습관처럼

설정 파일이라면 더더욱, 고치기 전에 원본을 복사해 두세요. 파일 이름 뒤에 .bak을 붙여 따로 저장해 두면, 문제가 생겨도 원래대로 되돌릴 수 있습니다. 이 작은 습관이 큰 사고를 막아 줍니다.

저장 후 검사하기

편집을 마쳤다면 'JSON validator(검사기)' 같은 온라인 도구에 붙여 넣어 문법이 맞는지 확인하는 것을 권합니다. 어디가 틀렸는지 위치까지 알려 주므로, 프로그램에 적용하기 전에 오류를 미리 잡을 수 있습니다.

다만 검사기에도 주의할 점이 있습니다. 비밀번호나 개인정보가 담긴 JSON이라면 외부 검사 사이트에 그대로 붙여 넣지 않는 것이 안전합니다. 이런 경우에는 코드 편집기가 자체적으로 짚어 주는 오류 표시를 활용하는 편이 낫습니다.

한 줄로 뭉친 JSON을 펼치는 이유

프로그램이 주고받는 JSON은 용량을 줄이려고 줄바꿈 없이 한 줄로 저장되는 경우가 많습니다. 사람이 보기엔 암호처럼 느껴지지만, 내용이 잘못된 것은 아닙니다.

이럴 때 코드 편집기의 '서식 지정(정렬)' 기능을 쓰면 줄과 들여쓰기를 자동으로 맞춰 구조가 한눈에 들어옵니다. 반대로 작업을 마친 뒤 다시 한 줄로 압축하는 기능도 있어, 용량을 줄여 저장할 수도 있습니다.

자주 묻는 질문

Q. JSON을 더블클릭하면 왜 브라우저가 열리나요?
컴퓨터가 JSON을 보여 줄 기본 프로그램을 브라우저로 잡아 둔 경우입니다. 편집하려면 파일을 직접 코드 편집기로 끌어다 놓거나, '연결 프로그램'을 코드 편집기로 바꾸면 됩니다.

Q. 수정했더니 프로그램이 안 켜져요. 어떡하죠?
대부분 문법 실수 때문입니다. 백업해 둔 원본으로 되돌린 뒤, 검사 도구로 어디가 틀렸는지 확인하고 다시 고치면 됩니다. 그래서 편집 전 백업이 중요합니다.

---

오늘 바로 적용: 한 줄로 뭉친 JSON 때문에 답답했다면, 코드 편집기에서 '서식 지정' 기능으로 펼쳐 보세요. 구조가 한눈에 들어옵니다.

다음 글에서는 JSON 과 자주 비교되는 XML이 무엇이 다른지, 어떤 상황에 어느 쪽이 어울리는지 살펴보겠습니다.