JSON 파일 열기와 보기 좋게 정렬하는 방법

JSON 파일은 특별한 프로그램이 없어도 메모장 같은 텍스트 편집기로 열 수 있습니다. 내용이 한 줄로 길게 붙어 있어 읽기 어렵다면 Firefox로 열거나 VS Code의 문서 서식 기능을 쓰면 보기 좋게 정렬됩니다.

이 글은 개발자가 아닌 분이 앱 설정 파일이나 서비스에서 내려받은 내보내기 파일을 망가뜨리지 않고 안전하게 확인하는 방법을 중심으로 설명합니다.

JSON 확장자는 어떤 파일인가요

.json은 JavaScript Object Notation의 줄임말로, 데이터를 글자로 적어 두는 형식입니다. 실행 파일이 아니라 순수한 텍스트라서 열어 보는 것만으로 컴퓨터에 무언가 설치되거나 실행되지 않습니다.

일반 사용자가 JSON 파일을 만나는 경우는 대체로 다음과 같습니다.

SNS나 클라우드 서비스에서 받은 개인 데이터 내보내기 파일
게임, 프로그램, 브라우저 확장의 설정 파일
가계부·메모 앱의 백업 파일
업무 시스템에서 받은 데이터 파일

내용은 {"이름": "홍길동", "나이": 30}처럼 중괄호, 따옴표, 콜론, 쉼표로 이루어져 있습니다. 이 기호들이 규칙대로 맞아야 프로그램이 파일을 읽을 수 있습니다.

JSON 파일 여는 방법 비교

목적에 따라 알맞은 도구가 다릅니다. 내용만 확인할 때는 브라우저, 수정까지 해야 할 때는 편집기가 편합니다.

도구	설치	자동 정렬	수정	추천 상황
메모장 / 텍스트 편집	기본 내장	안 됨	가능	짧은 파일을 잠깐 볼 때
Firefox	필요	자동	안 됨	읽기만 할 때, 가장 안전
Visual Studio Code	필요	단축키로 정렬	가능	설정 파일을 고쳐야 할 때
Notepad++	필요(Windows)	플러그인 필요	가능	가벼운 편집기를 원할 때
JSON 포매터(웹)	필요 없음	버튼 한 번	가능	민감 정보가 없는 짧은 데이터

메모장으로 바로 열기

가장 빠른 방법은 운영체제에 기본으로 있는 편집기를 쓰는 것입니다.

JSON 파일을 마우스 오른쪽 버튼으로 클릭합니다.
Windows는 연결 프로그램에서 메모장을, macOS는 다음으로 열기에서 텍스트 편집을 고릅니다.
한글이 깨져 보이면 대부분 인코딩 문제입니다. 다른 편집기로 열어 UTF-8로 표시되는지 확인합니다.

다만 기본 편집기는 줄바꿈과 들여쓰기를 자동으로 해 주지 않습니다. 한 줄로 수천 글자가 이어진 파일이라면 아래 방법을 쓰는 편이 낫습니다.

Firefox로 JSON 뷰어처럼 보기

Firefox에는 JSON 뷰어가 기본으로 들어 있습니다. 별도 확장 프로그램 없이도 파일을 열면 항목을 접고 펼 수 있는 트리 형태로 보여 줍니다. 비개발자에게 가장 권하는 방법입니다. 보기 전용이라 실수로 내용을 바꿀 일이 없기 때문입니다.

Firefox를 실행합니다.
JSON 파일을 브라우저 창으로 끌어다 놓습니다. 또는 Ctrl+O(macOS는 Cmd+O)로 파일을 선택합니다.
화면 위쪽 탭에서 JSON(트리 보기), 원시 데이터, 헤더를 오갈 수 있습니다.
원시 데이터 탭에서 예쁘게 표시를 누르면 들여쓰기된 형태로 바뀝니다.
필터 입력칸에 단어를 넣으면 해당 값이 들어 있는 항목만 추려 볼 수 있습니다.

SNS 내보내기 파일처럼 용량이 큰 데이터에서 특정 날짜나 이름을 찾을 때 필터 기능이 특히 유용합니다. Firefox는 Mozilla 공식 사이트에서 받을 수 있습니다.

VS Code로 JSON 정렬하고 수정하기

설정 값을 직접 바꿔야 한다면 Visual Studio Code가 편합니다. 무료로 쓸 수 있고 JSON 문법 검사가 기본으로 들어 있어, 쉼표 하나가 빠져도 빨간 밑줄로 알려 줍니다. 설치 파일은 VS Code 공식 사이트에서 받습니다.

정렬하는 방법

VS Code에서 파일 메뉴의 열기로 JSON 파일을 엽니다.
편집 화면에서 마우스 오른쪽 버튼을 누르고 문서 서식(Format Document)을 선택합니다.
단축키는 Windows에서 Shift+Alt+F, macOS에서 Shift+Option+F가 기본값입니다. Linux는 Ctrl+Shift+I인 경우가 많습니다.

문법 오류 확인하기

오류가 있으면 해당 줄에 빨간 물결선이 생기고, 화면 아래 문제 패널에 목록이 나옵니다. 파일을 저장하기 전에 이 패널이 비어 있는지 확인하는 습관을 들이면 설정 파일을 고장 낼 위험이 크게 줄어듭니다.

Notepad++로 보기

Windows에서 가벼운 편집기를 선호한다면 Notepad++도 쓸 만합니다. 설치는 Notepad++ 다운로드 안내를 참고하세요. 여러 프로그램이 비슷한 이름으로 배포되므로 받기 전에 개발자 정보를 한 번 확인하는 것이 좋습니다.

Notepad++는 기본 상태에서 JSON을 색으로 구분해 보여 주지만, 자동 정렬은 하지 않습니다. 정렬이 필요하면 플러그인 메뉴의 플러그인 관리에서 JSON Viewer 같은 플러그인을 설치한 뒤 사용합니다. 메뉴 이름과 위치는 버전에 따라 달라질 수 있습니다.

설치 없이 정렬하기와 안전 수칙

프로그램을 설치하기 어렵다면 설치 없이 바로 ssdown의 JSON 포매터에 내용을 붙여 넣으면 됩니다. 정렬, 한 줄 압축, 문법 검사를 한 화면에서 할 수 있습니다. 다른 시스템에 넣으려고 XML 형식이 필요하다면 JSON → XML 변환기를 쓰면 됩니다.

어떤 웹 도구를 쓰든 아래 원칙은 지키는 것이 좋습니다.

민감 정보 확인: 설정 파일에는 비밀번호, API 키, 토큰, 이메일 주소가 들어 있는 경우가 많습니다. password, token, key, secret 같은 항목은 웹에 붙여 넣기 전에 지우거나 가립니다. 민감한 파일은 Firefox나 VS Code처럼 내 컴퓨터에서만 여는 방법이 안전합니다.
원본 백업: 수정하기 전에 파일을 복사해 settings_backup.json처럼 따로 보관합니다.
프로그램 종료 후 수정: 실행 중인 프로그램은 종료할 때 설정을 덮어쓸 수 있습니다. 해당 프로그램을 끈 상태에서 고칩니다.
따옴표와 쉼표 주의: 문자열은 큰따옴표(")만 쓸 수 있고, 마지막 항목 뒤에 쉼표를 붙이면 오류가 나는 경우가 많습니다.

자주 묻는 질문

JSON 파일을 더블클릭해도 안 열려요.

파일과 연결된 프로그램이 없어서 그렇습니다. 오른쪽 클릭 후 연결 프로그램에서 메모장, VS Code, Firefox 중 하나를 고르면 됩니다. 항상 같은 프로그램으로 열고 싶다면 기본 프로그램으로 지정하는 옵션을 켭니다.

JSON 파일을 엑셀로 볼 수 있나요?

최신 Excel은 데이터 가져오기 기능(파워 쿼리)으로 JSON을 불러와 표로 바꿀 수 있습니다. 다만 구조가 여러 겹으로 중첩된 파일은 표로 펼치는 과정이 필요합니다. 메뉴 구성은 버전마다 다르니 사용 중인 Excel에서 확인해 보세요.

정렬하면 파일 내용이 바뀌나요?

정렬은 줄바꿈과 들여쓰기만 추가하므로 데이터의 의미는 그대로입니다. 프로그램도 정렬 전후 파일을 똑같이 읽습니다. 용량을 줄여야 할 때는 반대로 압축(minify)하면 됩니다.

JSON 파일을 열었더니 바이러스가 걸릴 수 있나요?

JSON은 텍스트라서 편집기나 브라우저로 여는 것만으로 코드가 실행되지는 않습니다. 다만 이름만 .json이고 실제로는 다른 형식인 파일도 있을 수 있으니 출처가 불분명한 파일은 텍스트 편집기로만 열어 보세요.

정리

JSON 파일은 텍스트 파일이라 메모장으로도 열 수 있고, 읽기만 할 때는 Firefox의 내장 JSON 뷰어가 가장 편하고 안전합니다. 설정을 고쳐야 한다면 문법 검사가 되는 VS Code에서 문서 서식으로 정렬한 뒤 수정하세요. 수정 전 백업, 비밀번호·토큰 같은 민감 정보 확인, 저장 전 오류 확인만 지켜도 파일을 망가뜨릴 일은 거의 없습니다.