liminfo

JSON to CSV

JSON을 CSV로 변환

JSON to CSV 소개

JSON to CSV 변환 도구는 JSON 객체 배열을 올바른 형식의 CSV 스프레드시트로 브라우저에서 직접 변환합니다. 배열의 모든 객체를 스캔해 고유 키를 모두 수집하고 헤더 행을 구성하며, 각 객체의 값을 해당 열에 매핑합니다. 일부 객체에 없는 필드는 빈 문자열로 채웁니다. 선택한 구분자, 큰따옴표, 줄바꿈이 값 안에 포함된 경우 RFC 4180 인용 규칙에 따라 자동으로 이스케이프 처리하므로 Excel, Google Sheets, 모든 표준 CSV 파서에서 안전하게 열 수 있습니다.

이 도구는 API나 데이터베이스에서 JSON을 받아 스프레드시트 소프트웨어나 CSV만 지원하는 하위 시스템에 임포트해야 하는 데이터 엔지니어, 분석가, 백엔드 개발자, 비기술 사용자가 활용합니다. 구분자 선택기로 쉼표(기본), 탭(TSV), 세미콜론(유럽 로케일 Excel), 파이프를 지원해 사실상 모든 실무 CSV 방언을 처리할 수 있습니다. 변환 결과를 UTF-8로 인코딩된 data.csv 파일로 직접 다운로드할 수도 있습니다.

처리가 전적으로 클라이언트 측 JavaScript의 JSON.parse와 배열 메서드로 이루어지므로 데이터가 기기를 떠나지 않습니다. 브라우저 메모리가 허용하는 범위 내에서 임의 크기의 배열을 처리하며, 입력이 JSON 배열이 아닐 경우 명확한 오류 메시지로 올바른 형식을 안내합니다.

주요 기능

  • 클릭 한 번으로 JSON 객체 배열을 CSV로 변환
  • 모든 객체의 고유 키를 자동 탐색해 헤더 행 구성
  • 일부 객체에 없는 필드를 빈 문자열로 채워 일관된 열 구조 유지
  • RFC 4180 규격 준수 — 구분자, 큰따옴표, 줄바꿈 자동 이스케이프
  • 쉼표, 탭, 세미콜론, 파이프 구분자로 모든 CSV 방언 지원
  • CSV 출력을 클립보드에 원클릭 복사
  • UTF-8 인코딩된 data.csv 파일로 직접 다운로드
  • 100% 클라이언트 사이드 — JSON 데이터가 브라우저 밖으로 나가지 않음

자주 묻는 질문

어떤 JSON 형식을 입력해야 하나요?

이 도구는 객체 배열 형식의 JSON을 기대합니다. 예: [{"name":"Alice","age":30},{"name":"Bob","age":25}]. 각 객체가 CSV의 한 행이 됩니다. 단일 객체나 중첩 구조라면 먼저 배열로 변환해야 합니다.

일부 객체에 없는 필드는 어떻게 처리되나요?

변환기는 모든 객체를 스캔해 등장하는 모든 고유 키를 찾습니다. 특정 객체에 키가 없으면 해당 셀은 빈 문자열로 채워집니다. 데이터가 누락되거나 조용히 삭제되는 일은 없습니다.

값 안에 구분자 문자가 포함되면 어떻게 되나요?

RFC 4180 규칙에 따라 구분자, 큰따옴표, 줄바꿈을 포함한 값은 큰따옴표로 감싸집니다. 값 내부의 큰따옴표는 두 개를 연속 사용하는 방식으로 이스케이프되므로 Excel과 Google Sheets에서 안전하게 열립니다.

어떤 구분자를 선택해야 하나요?

대부분의 영어권 도구에는 쉼표를 사용하세요. 숫자 데이터에 쉼표가 포함된 소프트웨어에는 탭(TSV), 쉼표를 소수점 구분자로 쓰는 유럽 로케일 Excel에는 세미콜론, 데이터에 쉼표와 세미콜론이 모두 있지만 파이프는 없는 경우 파이프를 선택하세요.

중첩된 JSON도 변환할 수 있나요?

이 도구는 한 단계 중첩까지, 즉 평탄한 객체 배열에서 동작합니다. 값 안에 중첩 객체나 배열이 있으면 해당 셀에 JSON 문자열로 표현됩니다. 복잡한 계층 구조 데이터라면 jq 등으로 먼저 평탄화하는 것을 권장합니다.

다운로드된 CSV 파일의 인코딩은 무엇인가요?

다운로드 파일은 UTF-8로 인코딩된 CSV로 MIME 타입은 text/csv입니다. 한국어, 중국어, 아랍어 등 비ASCII 문자를 올바르게 처리합니다. Excel에서 글자가 깨지면 "데이터 > 텍스트/CSV에서" 메뉴로 가져오기를 선택하고 UTF-8 인코딩을 지정하세요.

JSON 입력 크기 제한이 있나요?

별도의 크기 제한은 없으며, 브라우저 메모리가 허용하는 만큼 처리합니다. 수십 메가바이트 규모의 대용량 데이터도 현대 브라우저에서 문제없이 처리되지만, 매우 큰 입력은 파싱 중 잠깐의 지연이 발생할 수 있습니다.

JSON 데이터가 안전하게 처리되나요?

네. 모든 변환은 브라우저 내 JavaScript로만 이루어집니다. 서버로 전송되거나 저장되는 데이터는 없습니다. 민감하거나 기밀인 데이터에도 안전하게 사용할 수 있습니다.