JSON CSV 변환기

JSON to CSV 변환기는 계층적이고 구조화된 JavaScript Object Notation (JSON) 데이터를 평면적인 2차원 쉼표 구분 값 (CSV) 스프레드시트로 변환합니다. JSON은 REST API와 NoSQL 데이터베이스의 범용 표준이며, CSV는 Excel, Google Sheets 및 관계형 데이터베이스 입력의 표준입니다. 본 웹 도구는 파일 업로드나 회원가입, 용량 제한 없이 100% 사용자 브라우저 내부에서 모든 작업을 안전하게 처리합니다.

JSON을 CSV로 변환하는 방법

JSON에서 CSV로의 변환은 간단한 3단계로 이루어집니다:

1. JSON 데이터 불러오기: JSON 텍스트 붙여넣기, .json 또는 .jsonl 파일 업로드, 공개 URL 가져오기를 지원합니다. 객체 배열, 2D 행렬 및 중첩 구조를 자동으로 파싱합니다.
2. 열 구성 및 출력 미리보기: 감지된 모든 필드가 데이터 유형 및 채움 비율과 함께 미리보기 표에 표시됩니다. 열 이름 변경, 순서 조정, 제외 및 구분 기호(쉼표, 세미콜론, 탭, 파이프)를 설정할 수 있습니다.
3. CSV 또는 Excel 다운로드: 표준 CSV, Excel 호환 UTF-8 BOM CSV 또는 정식 Microsoft Excel .xlsx 통합 문서로 즉시 내보낼 수 있습니다.

중첩된 JSON 구조를 CSV로 평탄화

JSON은 트리 형태의 계층 구조이며 CSV는 평면적인 행과 열 구조입니다. 중첩된 레코드를 변환할 때 각 하위 속성은 customer.address.city와 같이 전체 경로가 명시된 개별 열로 자동 변환됩니다. 경로 구분자(점, 밑줄, 슬래시)를 변경하거나 최대 탐색 깊이를 제한할 수 있습니다.

JSON 배열과 객체 처리 방식

JSON 레코드 내부의 배열은 테이블의 단일 셀에 바로 담을 수 없으므로 변환 규칙이 필요합니다. 본 도구는 4가지 전략을 제공합니다:

• 인덱스별 열 분할: items.0, items.1과 같이 인덱스별로 독립된 열을 생성합니다. 크기가 고정된 목록에 적합합니다.
• 요소별 행 분할 (Unwind): 배열의 각 항목마다 상위 필드를 복제하여 여러 행으로 분할합니다. SQL 관계형 테이블의 표준 형식입니다.
• 단일 셀 결합: 세미콜론이나 파이프 등의 구분 기호를 사용하여 배열 요소를 따옴표로 감싼 한 셀로 결합합니다 (예: "tag1; tag2").
• 원시 JSON 문자열: ["tag1", "tag2"] 형태의 파싱되지 않은 JSON 텍스트를 그대로 CSV 셀에 보존합니다.

JSON to CSV 변환 실제 예시

실제 고객 주문 데이터를 표 형식으로 변환하는 예시입니다:

[
  {
    "orderId": "ORD-2048",
    "customer": { "name": "Elena Rostova", "email": "elena@example.com" },
    "total": 149.50,
    "status": "shipped"
  },
  {
    "orderId": "ORD-2049",
    "customer": { "name": "Marcus Vance", "email": "marcus@example.com" },
    "total": 89.00,
    "status": "pending"
  }
]

변환기는 두 레코드를 모두 분석하여 모든 필드를 포함하는 통합 헤더를 생성하고 중첩된 customer 객체를 평탄화하여 깔끔한 CSV를 출력합니다:

orderId,customer.name,customer.email,total,status
ORD-2048,Elena Rostova,elena@example.com,149.5,shipped
ORD-2049,Marcus Vance,marcus@example.com,89,pending

JSON과 CSV의 주요 차이점

JSON과 CSV의 구조적 특성을 이해하면 적절한 파일 형식을 선택하는 데 도움이 됩니다:

Python에서 pandas 또는 표준 라이브러리로 변환하기

Python 파이프라인에서 변환을 자동화하려는 경우 pandas를 사용하면 3줄로 간단히 처리할 수 있습니다:

import json

import pandas as pd

with open("input.json", encoding="utf-8") as handle:
    data = json.load(handle)

frame = pd.json_normalize(data, sep=".")
frame.to_csv("output.csv", index=False)

외부 패키지가 없는 환경에서는 Python 표준 라이브러리(json 및 csv.DictWriter)로도 동일하게 구현 가능합니다. 64비트 정수 ID의 정밀도 손실을 방지하려면 json.load에 parse_int=str을 전달하세요.

Node.js에서 JSON을 CSV로 변환하기

Node.js 환경에서는 외부 패키지 없이 기본 내장 모듈만으로 평면 JSON 레코드를 변환할 수 있습니다:

import { readFile, writeFile } from 'node:fs/promises';

const data = JSON.parse(await readFile('input.json', 'utf8'));
const fields = [...new Set(data.flatMap((row) => Object.keys(row)))];

const cell = (value) => {
  const text = value == null ? '' : String(value);
  return /[",\n]/.test(text) ? '"' + text.replaceAll('"', '""') + '"' : text;
};

const csv = [fields, ...data.map((row) => fields.map((field) => row[field]))]
  .map((row) => row.map(cell).join(','))
  .join('\n');

await writeFile('output.csv', csv, 'utf8');

완전 무료 및 용량 무제한의 원리

기존 온라인 도구는 파일을 원격 서버로 업로드하기 때문에 서버 유지비용이 발생하여 파일 크기 제한이나 유료 구독을 요구합니다. jsoncsvonline은 Web Worker를 사용하여 100% 브라우저 내에서 직접 동작하므로 데이터가 기기 외부로 유출되지 않으며 대기열이나 일일 할당량이 없습니다. 자세한 기술 내용은 중첩 JSON 평탄화 가이드, JSON 배열 변환 방법 및 Excel 호환 CSV 구분 기호와 문자 인코딩 설정을 참고하세요.

변환 전 JSON 구문 검증, 서식 정리 및 자동 복구

CSV나 Excel로 변환하기 전에 구문 오류를 미리 확인하면 변환 실패를 방지할 수 있습니다. RFC 8259 표준 검증을 위한 JSON 검증기, 누락된 따옴표와 쉼표를 수정하는 JSON 자동 복구 도구, 보기 쉽게 정렬하는 JSON 포맷터, 변경 사항을 비교하는 JSON Diff 비교 도구, 프로덕션용으로 압축하는 JSON 압축기도 함께 활용해 보세요.