JSON CSV XML YAML 차이, 설정 파일 오류 찾는 법

JSON CSV XML YAML 차이, 설정 파일 오류 찾는 법

자동화 도구나 AI 설정을 만지다 보면 config.json, data.csv, settings.xml, docker-compose.yml처럼 생소한 확장자를 가진 파일들을 열어 수정해야 할 일이 생깁니다. 보기에는 다 똑같은 영어 텍스트 파일 같은데, 어디에는 중괄호({})와 큰따옴표가 가득하고, 어디에는 꺽쇠(<>)가, 또 다른 파일에는 괄호 하나 없이 띄어쓰기 줄 맞춤만 되어 있습니다.

더 난감한 것은 메모장에서 숫자 하나만 고쳐 저장했을 뿐인데 갑자기 프로그램이 “파싱 오류(Syntax Error)”를 내며 아예 켜지지 않을 때입니다. 오늘은 JSON CSV XML YAML 차이가 왜 생겼는지 이해하고, 비전공자도 설정 파일 속 괄호·쉼표·들여쓰기 오류를 한눈에 잡아내는 요령을 알아보겠습니다.

프로그램 설정이나 API 문서를 열 때마다 등장하는 생소한 확장자들

컴퓨터 프로그램과 웹 서비스가 데이터를 주고받거나 설정을 저장할 때는 사람이 읽는 워드 문서 대신 기계가 빠르고 오해 없이 읽을 수 있는 정해진 서식을 씁니다. 다만 엑셀처럼 가로·세로 칸이 반듯한 표 데이터도 있고, “A 사용자 안에 주소 2개, 취미 3개”처럼 나무 가지처럼 뻗어 나가는 복잡한 데이터도 있습니다.

데이터의 모양(표 형태 vs 계층 형태)과 읽는 주체(기계 속도 우선 vs 사람 편집 편의 우선)가 다르기 때문에 한 가지 파일 포맷으로 통일하지 못하고 목적에 맞는 여러 포맷이 함께 쓰입니다.

계층 구조와 용도에 따른 JSON CSV XML YAML 차이 원리

JSON CSV XML YAML 차이는 물건을 정리하는 네 가지 수납함에 비유할 수 있습니다. CSV(Comma-Separated Values)는 칸칸이 줄이 그어진 단순한 반찬통·출석부입니다. 평면 표는 아주 가볍고 엑셀과 잘 맞지만, 한 칸 안에 다시 하위 표를 넣는 계층 구조는 표현하기 어렵습니다.

반면 XML(Extensible Markup Language)은 상자마다 뚜껑과 바닥에 라벨(<이름>...</이름>)을 일일이 붙이는 꼼꼼한 공문서 스타일이고, JSON(JavaScript Object Notation)은 불필요한 닫는 태그를 없애고 중괄호 {}와 대괄호 [], "키": 값 쌍으로 가볍게 묶어 웹 API 통신 표준이 되었습니다. 그리고 YAML(YAML Ain’t Markup Language)은 사람이 설정 파일을 눈으로 편하게 읽고 고칠 수 있게 괄호마저 없애고 줄바꿈과 공백 들여쓰기만으로 상하 계층을 구분합니다. 물론 실제 파싱에서는 각 포맷마다 허용되는 자료형과 주석 가능 여부(예: 표준 JSON은 주석 // 불가, YAML·XML은 주석 가능)에 엄격한 문법 규칙이 적용된다는 점이 비유와 다릅니다.

눈으로 읽고 괄호·쉼표·들여쓰기 문법 오류를 찾는 4단계

설정 파일을 조금 고친 뒤 프로그램이 오류를 낼 때는 대부분 아주 사소한 기호 하나 때문입니다. 아래 4가지 포인트만 짚어 보면 90% 이상 금방 찾을 수 있습니다.

설정·데이터 파일 문법 오류 1차 점검 4단계

  1. JSON: 큰따옴표, 마지막 줄 쉼표(Trailing Comma), 주석 금지 확인: JSON은 키와 문자열을 반드시 작은따옴표가 아닌 큰따옴표(")로 감싸야 합니다. 또한 목록이나 객체의 맨 마지막 항목 뒤에 쉼표(,)가 남거나, 설정 설명을 적겠다고 # 또는 // 주석을 넣으면 즉시 오류가 납니다. { }와 [ ]의 짝도 맞는지 확인합니다.
  2. YAML: Tab 키 대신 Space(공백) 들여쓰기 및 콜론 뒤 한 칸 띄우기: YAML 파일에서 가장 흔한 오류는 Tab 키를 섞어 쓰는 것입니다. YAML은 탭 문자를 문법 오류로 거부하므로 반드시 스페이스바 2칸 또는 4칸으로 세로 줄을 맞춰야 하며, key: value처럼 콜론(:) 뒤에 공백을 한 칸 꼭 띄워야 인식됩니다.
  3. CSV: 내용 안에 쉼표가 있을 때 큰따옴표로 감싸기: 주소나 금액("1,200원")에 쉼표가 들어갔는데 큰따옴표로 묶지 않으면 열이 한 칸씩 밀려 버립니다.
  4. 메모장 대신 VS Code나 문법 검증기로 빨간 밑줄 바로 찾기: 일반 윈도우 메모장에서는 괄호 짝이 틀려도 표시가 나지 않지만, VS Code로 파일을 열면 틀린 줄에 즉시 빨간 물결선이 뜨고 괄호 짝을 색깔로 칠해 줍니다. (단, 비밀번호·API 키가 든 설정 파일은 온라인 공개 문법 검사 웹사이트에 그대로 붙여 넣지 말고 내 PC의 VS Code 등 로컬 도구에서 점검하세요.)

4가지 대표 데이터·설정 포맷 특징 비교 표

구분 CSV JSON XML YAML (.yml/.yaml)
구조 방식 쉼표 구분 평면 표 {}·[] 중괄호 계층 <태그>...</태그> 계층 공백 들여쓰기 계층
주석 작성 불가 표준 JSON 불가 가능 (<!-- -->) 가능 (#)
주 사용처 엑셀·대량 표 데이터 웹 API 통신, 앱 설정 전자세금계산서, 오피스 내부 구조, 공공 API Docker, 클라우드·AI 파이프라인 설정
흔한 실수 값 내부 쉼표, 인코딩 깨짐 마지막 줄 쉼표, 작은따옴표 사용 닫는 태그 오타, & 미이스케이프 Tab 키 사용, 들여쓰기 칸 수 어긋남

핵심 정리

JSON CSV XML YAML 차이는 결국 ‘표 형태를 가볍게 담을 것인가(CSV), 프로그램끼리 빠르게 계층 데이터를 주고받을 것인가(JSON), 사람이 직접 설정을 고치기 쉽게 쓸 것인가(YAML)’라는 목적의 차이에서 나옵니다. 오류를 만났을 때는 JSON의 마지막 쉼표·큰따옴표, YAML의 탭 금지와 공백 들여쓰기부터 점검하고, 가급적 VS Code 같은 코드 편집기로 열어 빨간 밑줄로 확인하면 안전합니다.

재발 방지 체크리스트

재발 방지 체크리스트

  • 설정 파일 편집 전 항상 원본 파일 사본(.bak) 하나 먼저 복사해 두기
  • JSON 수정 시 큰따옴표(") 사용, 마지막 항목 뒤 쉼표 제거, 주석 금지 확인하기
  • YAML 수정 시 Tab 키를 쓰지 말고 스페이스바로 들여쓰기 칸 수 맞추기
  • 민감한 키가 든 설정 파일은 온라인 웹 검사기 대신 PC 내 VS Code 등으로 문법 오류 확인하기