블로그로 돌아가기

메모장에서 .JSON 파일 만드는 방법

Jul 3, 20263 min read

JSON은 엄격한 규칙을 가진 일반 텍스트입니다. 메모장으로도 충분히 작성할 수 있습니다. 사람들이 흔히 실수하는 부분은 도구가 아니라 바로 문법(구문)입니다. 올바른 구조만 갖춘다면 파일을 저장하는 것은 매우 쉽습니다.

JSON 파일이란 무엇인가요?

JSON은 JavaScript Object Notation의 약자입니다. 중괄호 안에 데이터를 키-값(key-value) 쌍으로 저장하며, 중첩된 객체와 배열을 지원합니다. 앱, API, 설정 파일 등에서 가볍고 거의 모든 프로그래밍 언어에서 읽을 수 있기 때문에 널리 사용됩니다.

기본적인 JSON 파일은 다음과 같이 구성됩니다.

{
  "name": "John",
  "age": 28,
  "isActive": true,
  "skills": ["writing", "editing"]
}

단계별 가이드: 메모장에서 JSON 파일 만들기

1단계: 메모장 열기

컴퓨터에서 메모장을 열거나, 브라우저에서 무료 온라인 메모장을 이용하세요.

2단계: 여는 중괄호로 시작하기

모든 JSON 파일은 객체를 뜻하는 { 또는 배열을 뜻하는 [로 시작합니다. 대부분의 파일은 객체로 시작합니다.

3단계: 키(Key)와 값(Value) 추가하기

각 키(key)는 큰따옴표로 감싸고, 그 뒤에 콜론(:)과 값을 입력합니다. 각 쌍은 쉼표(,)로 구분합니다.

{
  "title": "Sample File",
  "version": 1
}

4단계: 중괄호 올바르게 닫기

모든 여는 중괄호나 대괄호는 닫는 기호와 짝이 맞아야 합니다. 객체나 배열의 마지막 키-값 쌍 뒤에는 쉼표(,)를 붙이지 않습니다.

5단계: .json 확장자로 저장하기

[파일]에서 [다른 이름으로 저장]을 선택합니다. '파일 형식' 드롭다운에서 '모든 파일'을 선택합니다. 파일 이름 뒤에 .json 확장자를 붙여서 저장합니다(예: data.json). 이 설정을 바꾸지 않고 저장하면 JSON으로 인식되지 않는 .txt 파일로 저장됩니다.

6단계: 사용하기 전에 유효성 검사하기

스크립트나 앱에서 사용하기 전에 JSON 에디터에 복사하여 유효한 형식인지 확인하세요. 미리 확인하면 나중에 디버깅하는 수고를 덜 수 있습니다.

꼭 기억해야 할 JSON 문법 규칙

  • 큰따옴표만 사용하세요. 키와 문자열 값에는 작은따옴표(')가 아닌 큰따옴표(")를 사용해야 합니다.

  • 마지막 쉼표는 생략하세요. 객체나 배열의 마지막 항목 뒤에는 쉼표를 붙이지 않습니다.

  • 주석은 지원되지 않습니다. 표준 JSON 파일 내부에는 // 혹은 /* */ 같은 주석을 작성할 수 없습니다.

  • 불리언(Boolean)은 소문자로 작성하세요. True나 FALSE가 아닌 true와 false를 사용합니다.

  • 숫자에는 따옴표가 필요 없습니다. 텍스트로 처리할 목적이 아니라면 "28"이 아닌 28로 작성하세요.

자주 발생하는 에러와 해결 방법

문제: 키-값 쌍 사이에 쉼표가 누락되었습니다. 해결책: 마지막 항목을 제외한 모든 키-값 쌍 뒤에는 쉼표를 붙여야 합니다.

문제: 대괄호나 중괄호의 짝이 맞지 않습니다. 해결책: {}와 []의 개수가 일치하는지 확인하세요. 유효성 검사 도구를 사용하면 짝이 맞지 않는 줄을 정확히 찾아낼 수 있습니다.

문제: 문자열 내부의 따옴표에 이스케이프 처리가 되지 않았습니다. 해결책: 문자열 안의 따옴표는 백슬래시를 사용해 이스케이프 처리합니다(예: "He said \"hello\"").

문제: 키에 따옴표가 없습니다. 해결책: id나 name 같은 간단한 키라도 모든 키는 반드시 큰따옴표로 감싸야 합니다.

마치며

JSON 파일은 엄격한 형식을 따르는 텍스트 파일일 뿐입니다. 키와 값을 큰따옴표로 감싸고, 괄호의 짝을 맞추고, 마지막 쉼표를 지운 뒤, .json 확장자로 저장하기만 하면 됩니다. 사용하기 전에 유효성 검사기로 한 번 확인만 거치면 준비는 끝납니다.

관련 글