JSON → CSV 변환기이란?

JSON to CSV Converter는 객체로 이루어진 JSON 배열을 CSV 파일로 변환합니다. JSON 키에서 열 헤더를 읽고, 중첩 객체를 평탄화하며, 구분자도 직접 선택할 수 있습니다. 이 데이터를 스프레드시트나 데이터베이스에 넣어야 할 때 쓸모가 있습니다.

변환기는 객체 배열을 처리하고, 첫 레코드에서 열 이름을 가져온 뒤 이후에 나타난 키도 합쳐서 어떤 필드도 빠지지 않게 합니다. 중첩 객체는 점 표기 열(address.city, address.zip)로 펼치거나, JSON 문자열 한 열에 그대로 담을 수 있습니다. 구분자는 쉼표, 세미콜론, 탭, 파이프 중에서 고를 수 있습니다.

사용 방법

1. 1단계 — JSON 객체 배열을 붙여넣거나(예: [{"name": "Alice", "age": 30}, ...]), .json 파일을 입력 칸에 끌어다 놓거나, 파일 선택을 누르거나, URL에서 바로 JSON을 불러옵니다. JSON Lines(NDJSON, 한 줄에 객체 하나)도 지원합니다.
2. 2단계 — 구분자(쉼표, 세미콜론, 탭 또는 파이프)를 선택하고, 헤더 행 포함 여부를 결정하고, 중첩 객체 처리 방식(점 표기법 평탄화 또는 문자열화)을 선택합니다.
3. 3단계 — 편집하는 동안 CSV가 실시간으로 갱신됩니다. 표 형식 미리보기로 확인한 뒤 복사하거나 CSV, TSV, 바로 열리는 Excel(.xlsx) 파일로 다운로드합니다.

사용 시기

• API 익스포트(사용자 목록, 주문 내역)를 Excel, Google 스프레드시트, 데이터베이스로 가져올 때.
• JSON이 아닌 스프레드시트로 일하는 사람과 표 데이터를 공유할 때.
• CSV만 받는 도구에 레코드를 넣을 때. 대량 업로드 양식이나 분석 도구 가져오기 같은 경우.

결과

API에서 500개의 사용자 레코드를 JSON으로 내보냅니다. 배열을 붙여 넣고 중첩 객체 평탄화와 쉼표 구분자를 선택하면 address.city, address.zip 같은 열이 포함된 깔끔한 CSV 파일을 Excel에서 바로 열 수 있습니다.

자주 묻는 질문

CSV로 변환할 때 중첩 객체는 어떻게 처리되나요?

펼치기 옵션을 켜면 {address: {city: 'X', zip: 'Y'}}는 address.city와 address.zip 두 열이 됩니다. 끄면 객체 전체가 한 열에 JSON 문자열로 들어가므로 구조는 유지되지만 스프레드시트에서 다루기는 불편합니다.

예상하지 못한 열이 출력에 왜 추가됐나요?

배열 안에서 레코드마다 키가 다르면 변환기가 합집합을 만들어 데이터를 잃지 않습니다. 해당 키가 없는 레코드는 그 열에서 빈 셀이 됩니다. 엄격한 스키마를 원한다면 변환 전에 JSON을 정리하세요.

구분자는 쉼표, 세미콜론, 탭, 파이프 중 무엇을 골라야 하나요?

영어판 Excel과 대부분의 도구는 쉼표. 유럽판 Excel은 쉼표를 소수점 구분자로 쓰므로 세미콜론을 사용. 탭은 셀에 바로 붙여넣거나, 텍스트에 쉼표가 포함돼 따옴표를 두기 싫을 때 편리합니다. 파이프(|)는 오래된 데이터베이스 덤프나 막대 구분 값을 기대하는 로그 파이프라인에 적합합니다.

값 안에 쉼표, 따옴표, 줄바꿈이 있으면 어떻게 처리되나요?

변환기는 RFC 4180을 따릅니다. 쉼표·따옴표·줄바꿈을 포함한 필드는 큰따옴표로 감싸고, 내부 큰따옴표는 두 번 반복합니다("는 ""). Excel과 대부분의 CSV 파서는 별도 설정 없이 정확히 읽습니다.

다운로드 전에 열 순서를 바꿀 수 있나요?

가능합니다. 미리보기의 각 헤더에 좌우 화살표가 있어 클릭하면 열이 한 칸씩 이동합니다. 정렬을 마친 뒤 그대로 .csv 파일을 내려받으세요.

관련 도구