JSON을 CSV로 변환하기
JSON은 앱과 API가 데이터를 주고받는 형식입니다. CSV는 스프레드시트, 데이터베이스, 가져오기 도구가 읽는 형식입니다. 웹 서비스에서 주문, 연락처, 로그를 내보내면 JSON으로 나오는 경우가 많은데, 상사나 쇼핑몰 프로그램, 메일 발송 도구는 CSV를 원합니다.
이 변환기는 JSON 배열을 CSV 행으로 바꿉니다. 객체 하나가 한 행, 키 하나가 한 열이 됩니다. JSON을 붙여넣거나 .json 파일을 열면 입력하는 대로 아래에 CSV가 나타납니다.
모든 작업은 브라우저 안에서 이루어집니다. 데이터는 업로드되지 않습니다.
주요 기능
- 실시간 출력 — 입력하거나 붙여넣는 즉시 CSV가 바뀝니다
- 중첩 객체 펼치기 — {"address": {"city": "London"}}은 address.city 열이 됩니다
- 모든 키가 열로 — 일부 객체에만 있는 키도 열이 됩니다
- 목록 자동 찾기 — 행이 {"data": [...]} 같은 객체 안에 있어도 그 목록을 사용합니다
- .json 파일 열기 또는 끌어놓기 — CSV 파일 이름도 같게 저장됩니다
- 구분자 — 쉼표, 세미콜론, 탭, 파이프
- 정확한 따옴표 처리 — 값 안의 쉼표, 따옴표, 줄바꿈도 안전하게 보존됩니다
중첩 JSON이 열이 되는 방식
CSV는 평평한 표입니다. 한 행에 열마다 값 하나씩 들어갑니다. JSON은 중첩될 수 있습니다. 중첩 객체 펼치기를 켜면(기본값) 변환기가 각 객체 안으로 들어가 키를 점으로 이어 붙입니다. 값 종류별 처리는 다음과 같습니다.
| JSON 값 | CSV 셀 |
|---|---|
"name": "Ada" | 열 name = Ada |
"address": {"city": "London", "zip": "W1J 7NT"} | 열 address.city = London, 열 address.zip = W1J 7NT |
"tags": ["math", "code"] | 열 tags = math, code |
"items": [{"id": 1}, {"id": 2}] | 열 items = 목록을 JSON 텍스트로 표시 |
"paid": true | true |
"note": null | 빈 셀 |
펼치기를 끄면 중첩 객체가 JSON 텍스트로 셀 하나에 들어갑니다. 잃는 데이터가 없고 「[object Object]」가 나오는 일도 없습니다.
상자의 예시는 다음 CSV가 됩니다.
| id | name | address.city | address.zip | tags |
|---|---|---|---|---|
| 1 | Ada Lovelace | London | W1J 7NT | math, code |
| 2 | José Álvarez | Madrid | 28013 | design |
행이 객체 안에 있을 때
많은 API는 목록을 객체로 감싸서 보냅니다. 예: {"status": "ok", "count": 2, "data": [ … ]}. 변환기는 안을 살펴 가장 긴 객체 목록을 찾아 사용합니다. 어떤 목록을 썼는지는 상자 아래 줄에 *「data」의 목록을 사용했습니다*처럼 표시됩니다. 안에 목록이 없는 단일 객체는 한 행이 됩니다.
쉼표일까, 세미콜론일까?
기본은 쉼표입니다. 하지만 유럽 여러 나라의 엑셀은 쉼표를 소수점으로 쓰기 때문에 세미콜론을 기대합니다. CSV를 엑셀에서 열었는데 모든 내용이 A열에 몰려 있다면, 세미콜론을 선택하고 다시 내려받으세요. 이 문제를 아예 피하려면 JSON 엑셀 변환으로 진짜 엑셀 파일을 만드세요.
자주 묻는 질문
JSON 파일을 CSV로 변환하려면 어떻게 하나요?
「.json 파일 열기」를 클릭하세요(파일을 상자에 끌어놓아도 됩니다). CSV가 바로 나타납니다. 내려받기를 누르면 저장되며, 파일 이름은 JSON과 같습니다.
중첩 객체는 어떻게 처리되나요?
중첩된 키마다 점으로 이어진 별도의 열이 됩니다. 예: customer.address.city. 「중첩 객체 펼치기」 체크를 해제하면 중첩 객체가 JSON 텍스트로 셀 하나에 들어갑니다.
객체마다 키가 다르면 어떻게 되나요?
어느 객체에든 있는 키는 모두 열이 됩니다. 그 키가 없는 행은 빈 셀이 됩니다.
CSV를 다시 JSON으로 바꿀 수 있나요?
네. 위쪽에서 CSV → JSON으로 전환하거나 CSV JSON 변환 페이지를 이용하세요.
크기 제한이 있나요?
아무것도 업로드하지 않으므로 업로드 제한이 없습니다. 다만 수십 MB의 매우 큰 파일은 변환하는 동안 페이지가 느려질 수 있습니다.
내 데이터는 안전한가요?
네. 변환은 브라우저 안에서 이루어지며 서버로 아무것도 전송되지 않습니다.
관련 도구
- JSON 엑셀 변환 — 같은 데이터를 진짜 .xlsx 통합 문서로
- CSV JSON 변환 — 반대 방향 변환
- JSON 포매터 — 먼저 JSON을 확인하고 정리하기
- CSV 파일 병합 — 이 CSV를 다른 CSV와 합치기
- CSV 엑셀 변환 — 앞자리 0을 잃지 않고 CSV를 엑셀에서 열기
사용 방법
- JSON을 상자에 붙여넣거나 .json 파일 열기를 클릭하세요
- 중첩 객체 펼치기를 켜 두면 중첩된 키마다 열이 하나씩 생깁니다
- 구분자를 고르세요. 대부분의 프로그램은 쉼표, 유럽 여러 나라의 엑셀은 세미콜론입니다
- 출력 상자에서 CSV를 확인하세요
- 복사를 누르거나, 내려받기로 .csv 파일을 저장하세요
