CSV는 어디서나 볼 수 있습니다 — 스프레드시트 내보내기, 데이터베이스 덤프, 분석 플랫폼, 레거시 시스템 모두 기본적으로 CSV를 사용합니다. 하지만 여러분의 API는 아마 JSON을 원할 것입니다. CSV를 JSON으로 변환하는 것은 현대 개발에서 가장 흔한 데이터 가공 작업 중 하나입니다.
CSV를 JSON으로 변환해야 하는 이유
| 시나리오 | JSON이 필요한 이유 |
|---|---|
| REST API 페이로드 | 대부분의 API는 JSON을 수신/반환 |
| NoSQL 데이터베이스 가져오기 | MongoDB, DynamoDB는 JSON 문서 사용 |
| JavaScript 프론트엔드 | JSON.parse()는 기본 지원; CSV는 파서 필요 |
| 데이터 변환 파이프라인 | JSON은 현대 ETL의 공통 교환 형식 |
| 스프레드시트에서 설정 관리 | 팀이 시트로 설정을 관리하고 앱이 JSON으로 소비 |
CSV 구조 기초
CSV(Comma-Separated Values) 파일은 두 부분으로 구성됩니다:
- 헤더 행 (선택적이지만 강력히 권장): 열 이름
- 데이터 행: 한 줄에 하나의 레코드, 구분자로 값을 분리
id,name,email,age,active
1,Alice,[email protected],30,true
2,Bob,[email protected],25,false
3,Charlie,[email protected],35,trueJSON 배열로 변환:
[
{ "id": "1", "name": "Alice", "email": "[email protected]", "age": "30", "active": "true" },
{ "id": "2", "name": "Bob", "email": "[email protected]", "age": "25", "active": "false" },
{ "id": "3", "name": "Charlie", "email": "[email protected]", "age": "35", "active": "true" }
]기본적으로 모든 값은 문자열입니다. 타입 추론("30" → 30 변환)은 도구에 따라 선택 사항입니다.
일반적인 변환 시나리오
기본 플랫 변환
가장 단순한 경우: 헤더 행이 JSON 키에 직접 매핑됩니다.
product_id,name,price,in_stock
P001,Widget,9.99,true
P002,Gadget,24.99,false결과:
[
{ "product_id": "P001", "name": "Widget", "price": "9.99", "in_stock": "true" },
{ "product_id": "P002", "name": "Gadget", "price": "24.99", "in_stock": "false" }
]타입 추론 변환
API 활용을 위해 숫자는 숫자로, 불리언은 불리언으로 변환합니다:
[
{ "product_id": "P001", "name": "Widget", "price": 9.99, "in_stock": true },
{ "product_id": "P002", "name": "Gadget", "price": 24.99, "in_stock": false }
]ZeroTool을 포함한 대부분의 변환기는 이를 위한 “타입 파싱” 옵션을 제공합니다.
쉼표가 포함된 따옴표 처리 필드
CSV는 값 내부의 쉼표를 따옴표로 처리합니다:
city,description
New York,"대도시, 금융 허브"
London,"역사적인 도시, 영국 수도"올바른 JSON 출력:
[
{ "city": "New York", "description": "대도시, 금융 허브" },
{ "city": "London", "description": "역사적인 도시, 영국 수도" }
]단순히 쉼표로 split하면 이 케이스가 깨집니다. 항상 제대로 된 CSV 파서를 사용하세요.
탭 구분 값 (TSV)
일부 내보내기는 쉼표 대신 탭을 사용합니다:
name score grade
Alice 95 A
Bob 82 B변환할 때 구분자를 지정하세요 — 대부분의 도구가 커스텀 구분자를 지원합니다.
엣지 케이스 처리
빈 값
id,name,email
1,Alice,[email protected]
2,Bob,
3,,[email protected]빈 값은 도구에 따라 ""(빈 문자열) 또는 null이 됩니다:
[
{ "id": "1", "name": "Alice", "email": "[email protected]" },
{ "id": "2", "name": "Bob", "email": "" },
{ "id": "3", "name": "", "email": "[email protected]" }
]헤더 행이 없는 경우
CSV에 헤더가 없으면:
- 열 이름 자동 생성:
col1,col2,col3 - 또는 변환 전 열 이름을 수동으로 지정
중복 열 이름
value,value,value
1,2,3동작은 변환기마다 다릅니다: 접미사 추가(value, value_1, value_2) 또는 덮어쓰기. 변환 전에 헤더를 중복 제거하세요.
코드에서 CSV를 JSON으로 변환하기
JavaScript (Papa Parse)
Papa Parse는 JavaScript의 표준 CSV 라이브러리입니다:
npm install papaparseconst Papa = require('papaparse');
const fs = require('fs');
const csv = fs.readFileSync('data.csv', 'utf8');
const result = Papa.parse(csv, {
header: true, // 첫 행을 키로 사용
dynamicTyping: true, // 숫자와 불리언 자동 변환
skipEmptyLines: true,
});
console.log(JSON.stringify(result.data, null, 2));Python (csv 모듈)
import csv
import json
with open('data.csv', newline='', encoding='utf-8') as f:
reader = csv.DictReader(f)
rows = list(reader)
print(json.dumps(rows, indent=2, ensure_ascii=False))타입 추론을 위해:
def coerce(value):
if value.lower() in ('true', 'false'):
return value.lower() == 'true'
try:
return int(value)
except ValueError:
pass
try:
return float(value)
except ValueError:
pass
return value
rows = [{k: coerce(v) for k, v in row.items()} for row in rows]커맨드라인 (csvkit)
# csvkit 설치
pip install csvkit
# JSON으로 변환
csvjson data.csv
# 보기 좋게 출력
csvjson data.csv | jq .Miller 사용
Miller는 다양한 데이터 처리 도구입니다:
# 설치: brew install miller
mlr --csv --ojson cat data.csvJSON to CSV: 역방향 변환
때로는 반대 방향이 필요합니다 — JSON 배열을 CSV로 평탄화해 Excel이나 Google Sheets에서 분석하는 것입니다.
[
{ "id": 1, "name": "Alice", "score": 95 },
{ "id": 2, "name": "Bob", "score": 82 }
]예상 CSV:
id,name,score
1,Alice,95
2,Bob,82중첩된 객체가 도전 과제입니다:
{ "id": 1, "user": { "name": "Alice", "email": "[email protected]" } }대부분의 변환기는 중첩 키를 구분자로 평탄화합니다: user.name, user.email. ZeroTool 변환기는 이를 자동으로 처리합니다.
대용량 CSV 성능 고려사항
수백만 행의 대용량 CSV 파일:
- 스트리밍: 전체 파일을 메모리에 로드하지 않고 행 단위로 처리
- NDJSON 출력: 줄 구분 JSON(한 줄에 JSON 객체 하나)은 단일 대용량 배열보다 스트리밍이 쉬움
- 타입 추론 오버헤드: 모든 셀의 타입 자동 감지는 CPU 비용 추가; 알려진 스키마에서는 비활성화
// Papa Parse로 NDJSON 스트리밍
Papa.parse(stream, {
header: true,
step: (row) => process.stdout.write(JSON.stringify(row.data) + '\n'),
complete: () => console.error('완료'),
});온라인 CSV↔JSON 변환기
빠른 임시 변환을 위해 ZeroTool의 CSV↔JSON 변환기는 브라우저에서 완전히 실행됩니다. CSV를 붙여넣거나 업로드하고, 옵션(구분자, 타입 파싱, 헤더 행)을 조정한 후 JSON을 다운로드하세요. 파일은 서버로 전송되지 않습니다.