</>DevTools

CSVJSON ↔ CSV 변환

JSON과 CSV 포맷 간 변환

JSON ↔ CSV 변환 완벽 가이드

JSON과 CSV는 데이터를 저장하고 교환하는 데 가장 많이 쓰이는 두 가지 포맷입니다. JSON은 계층적 데이터 표현에 강하고, CSV는 엑셀이나 Google Sheets에서 바로 열 수 있어 데이터 분석·공유에 유리합니다. REST API 응답을 스프레드시트로 가져오거나, 반대로 CSV 데이터를 JSON API 페이로드로 바꿀 때 이 도구가 즉각적인 해결책이 됩니다.

중첩 JSON과 배열 처리

기본 변환 규칙

JSON → CSV 변환의 핵심은 객체 배열(Array of Objects)입니다. 각 객체의 키가 CSV 헤더(열)가 되고, 값이 행 데이터가 됩니다.

// JSON 입력
[
  {"name": "Alice", "age": 30, "city": "Seoul"},
  {"name": "Bob",   "age": 25, "city": "Busan"}
]

// CSV 출력
name,age,city
Alice,30,Seoul
Bob,25,Busan

중첩 객체 주의사항

중첩된 객체({"address": {"city": "Seoul"}})는 자동 평탄화되지 않습니다. CSV로 변환하기 전에 JSON Formatter 도구에서 구조를 확인하고, 필요하다면 미리 평탄화하세요. 배열 값("roles": ["admin", "user"])은 문자열로 직렬화됩니다.

자주 발생하는 이스케이프 문제

  • 쉼표 포함 값: RFC 4180 표준에 따라 자동으로 큰따옴표로 감쌉니다.
  • 줄바꿈 포함 값: 큰따옴표로 감싸고 개행문자를 보존합니다.
  • 큰따옴표 포함 값: ""로 이스케이프됩니다.

엑셀에서 열 때 인코딩 이슈 해결

Excel이 CSV를 ANSI로 해석해 한글이 깨지는 경우, 두 가지 방법으로 해결할 수 있습니다. 첫째, Excel의 데이터 → 텍스트/CSV 가져오기에서 인코딩을 UTF-8로 지정합니다. 둘째, 메모장(Windows) 또는 TextEdit(Mac)에서 파일을 UTF-8 BOM으로 다시 저장합니다.

실전 예시: API 응답 → 스프레드시트

GitHub API, Notion API 등 REST API의 JSON 응답을 붙여넣고 JSON → CSV 버튼 클릭 한 번이면 바로 엑셀에서 열 수 있는 CSV가 완성됩니다. 복사 버튼으로 클립보드에 복사 후 Google Sheets에 바로 붙여넣기도 가능합니다.

🔗관련 도구🔄 텍스트/데이터 변환