JSON to CSV 변환기 (JSON to CSV Converter)

CSV란 무엇이며 JSON에서 왜 변환하나요?

// Input JSON
[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "editor" }
]

// Output CSV (RFC 4180 preset: comma + CRLF + no BOM)
id,name,role
1,Alice,admin
2,Bob,editor

// Same input with Stringify mode + nested data
[
  { "id": 1, "tags": ["a", "b"] }
]

// Becomes
id,tags
1,"[""a"",""b""]"

주요 기능

예시

[{"id":1,"name":"Alice Chen","email":"alice@example.com","role":"admin"},{"id":2,"name":"Bob Garcia","email":"bob@example.com","role":"editor"},{"id":3,"name":"Carol Singh","email":"carol@example.com","role":"viewer"},{"id":4,"name":"Dan Müller","email":"dan@example.com","role":"viewer"}]

[{"id":1001,"title":"Bug: login redirects to 404","state":"open","labels":["bug","priority:high"],"user":{"login":"alice"}},{"id":1002,"title":"Feature: dark mode toggle","state":"open","labels":["enhancement"],"user":{"login":"bob"}},{"id":1003,"title":"Docs: update README","state":"closed","labels":["docs","good-first-issue"],"user":{"login":"carol"}}]

[{"_id":{"$oid":"6634a1b2c3d4e5f600000001"},"email":"alice@example.com","metadata":{"signupDate":"2026-01-15T10:30:00Z","preferences":{"newsletter":true,"theme":"dark"}}},{"_id":{"$oid":"6634a1b2c3d4e5f600000002"},"email":"bob@example.com","metadata":{"signupDate":"2026-02-20T14:15:00Z","preferences":{"newsletter":false,"theme":"light"}}}]

{"event":"signup","user":"alice","ts":1715000000}
{"event":"login","user":"alice","ts":1715000060}
{"event":"checkout","user":"alice","ts":1715000300}

[{"id":"ord-001","customer":{"name":"Alice Chen","email":"alice@example.com","address":{"city":"Seattle","country":"US"}},"items":[{"sku":"SKU-100","qty":2},{"sku":"SKU-205","qty":1}]},{"id":"ord-002","customer":{"name":"Bob Garcia","email":"bob@example.com","address":{"city":"Madrid","country":"ES"}},"items":[{"sku":"SKU-100","qty":1}]}]

[{"name":"GET /users returns 200","status":"pass","duration":142},{"name":"POST /users creates record","status":"pass","duration":287},{"name":"GET /users/999 returns 404","status":"fail","duration":98,"error":"Expected 404, got 500"},{"name":"DELETE /users/1 returns 204","status":"pass","duration":156}]

사용 방법

1. 1

   JSON 붙여넣기

   위 입력 필드에 JSON을 입력하거나 붙여넣으세요. 도구는 객체 배열, 단일 객체, NDJSON(줄 구분 JSON)을 받아들이며 자동 감지합니다. '예시 불러오기'를 클릭하여 REST API 응답, MongoDB 내보내기, NDJSON 이벤트 로그 같은 샘플을 사용해 볼 수도 있습니다.

2. 2

   프리셋 선택(또는 옵션 조정)

   RFC 4180(기본값), Excel(EU 세미콜론 + BOM), TSV(Tab) 또는 Pipe를 클릭하여 한 번에 대상 형식을 설정하세요. 세밀한 제어를 위해 옵션 패널을 여세요: 구분자, 헤더, 인용(자동/항상), 줄 끝(LF/CRLF), BOM, 중첩(평탄화/문자열화).

3. 3

   CSV 복사 또는 다운로드

   복사를 클릭하여 CSV를 클립보드에 저장하거나 다운로드를 클릭하여 Excel, Google Sheets, PostgreSQL COPY, 또는 모든 데이터 파이프라인에서 바로 사용할 수 있는 .csv(TSV 프리셋의 경우 .tsv) 파일로 저장하세요. 왕복 변환을 위해 방향 전환을 클릭하면 그 자리에서 CSV를 다시 JSON으로 변환합니다.

일반적인 변환 함정

42

[{"value": 42}]

[
  {"name": "GET /users", "status": "pass"},
  {"name": "GET /users/999", "status": "fail", "error": "500"}
]

// Output CSV (note empty cell in row 1)
name,status,error
GET /users,pass,
GET /users/999,fail,500

{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

{"id": "9007199254740993"}
// CSV preserves the string; Excel displays exactly

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

id,name,price
1,Alice,1,234.56
// Excel-EU mis-parses 1,234.56 as two columns

// Excel preset output: ; + CRLF + BOM
id;name;price
1;Alice;1234,56
// Excel-EU reads cleanly with comma decimal

[
  {"event": "signup"},
  {"event": "login"}
]
// Detected as a regular JSON array (works, but not NDJSON path)

{"event": "signup"}
{"event": "login"}
// Each line is one JSON value — auto-detected as NDJSON

주요 사용 사례

API 응답을 스프레드시트로

REST API 응답(사용자/주문/이벤트 객체 배열)을 붙여넣어 Excel, Google Sheets 또는 Numbers에 바로 사용할 수 있는 깔끔한 표 형식의 CSV를 받으세요. 가장 일반적인 사용 사례입니다 — 분석가와 PM은 스프레드시트 형태의 데이터가 필요하고, 엔지니어는 백엔드에서 JSON을 보냅니다.

MongoDB 내보내기를 데이터 웨어하우스로

mongoexport JSON 출력($oid 래퍼와 중첩된 metadata 문서 포함)을 BigQuery, Snowflake 또는 Redshift에 로드하기 위한 CSV로 변환합니다. 다운스트림 도구가 셀 내 JSON을 지원할 때 문자열화 모드는 중첩 형태를 손실 없이 보존합니다.

GitHub Issues 분류

/repos/{owner}/{repo}/issues에서 이슈를 가져와 JSON을 붙여넣고 id, title, state, labels, user.login이 컬럼인 평탄한 CSV를 받으세요. 스프린트 계획 중에 필터링, 정렬, 할당하기 위해 Sheets에 넣으세요.

NDJSON 이벤트 로그 검토

Cloud Logging, Datadog, Vector 또는 자체 파이프라인의 스트리밍 로그는 종종 NDJSON(.ndjson, .jsonl)으로 도착합니다. 파일 내용을 직접 붙여넣으세요 — 자동 감지됩니다 — 그리고 실제 ETL 파이프라인을 구축하지 않고도 임시 분석을 위한 CSV를 받으세요.

전자상거래 주문 추출

중첩된 주문 JSON(customer.address.city, items 배열)을 재무, 이행 또는 사기 검토를 위한 평탄한 CSV로 변환합니다. 평탄화 모드는 리프 필드당 한 컬럼을 생성하여 임시 보고를 위해 Excel에 로드할 준비를 합니다.

Postman/Newman 테스트 보고서

Postman 테스트 내보내기에는 형식이 다른 행(일부에 선택적 error 필드 포함)이 포함됩니다. JSON을 붙여넣어 모든 키가 합쳐지고 누락된 셀이 채워진 CSV를 받으세요 — Sheets에서 비엔지니어와 실패한 테스트 보고서를 공유하기에 완벽합니다.

기술 세부 정보

RFC 4180 상태 머신 파서

양방향 모두 RFC 4180을 따르는 적절한 유한 상태 머신 파서를 사용합니다. 상태에는 UnquotedField, QuotedField, AfterQuote, RowEnd, EndOfInput이 포함됩니다. 파서는 구분자를 포함하는 인용된 필드, 인용된 필드 안에 내장된 CR/LF, 이스케이프된 큰따옴표(두 번 작성, ""), 후행 개행을 올바르게 처리합니다. 이는 Python의 csv 모듈, PostgreSQL COPY, AWS S3 SELECT, 모든 호환 파서를 통해 손실 없이 왕복하는 출력을 생성합니다.

큰 정수 감지 알고리즘

JSON.parse()(IEEE 754를 통해 큰 정수를 자동으로 반올림)를 통해 JSON을 전달하기 전에, 도구는 안전 범위(-2^53+1 ~ 2^53-1) 밖의 정수 리터럴을 찾기 위해 원본 JSON 텍스트에 대한 정규식 스캔을 실행합니다. 감지되면 영향받은 필드 경로가 기록되고 출력 아래에 큰 정수 경고 배너가 나타납니다. 그런 다음 CSV 작성기는 이러한 값을 문자열로 보존하여 Excel, Google Sheets, 모든 텍스트 인식 다운스트림 소비자를 통해 정확한 정밀도를 보장합니다.

Excel을 위한 BOM과 UTF-8 인코딩

모든 입력과 출력은 UTF-8입니다. 선택적 UTF-8 BOM(0xEF 0xBB 0xBF)은 BOM 토글이 켜져 있거나 Excel 프리셋이 선택되었을 때 출력 앞에 추가됩니다. Windows의 Excel은 BOM을 사용하여 UTF-8 인코딩을 감지합니다 — 없으면 Excel은 시스템 로케일(미국에서는 Windows-1252, 러시아에서는 Windows-1251 등)로 폴백하여 비ASCII 문자를 망칩니다. 현대 파서(Python csv, Pandas, jq, PostgreSQL)는 일반적으로 BOM이 필요하지 않으며 첫 셀의 시작 부분에 BOM을 떠다니는 문자로 포함시킬 수 있으므로, Excel 외 파이프라인에서는 BOM을 끄세요.

모범 사례

옵션을 조정하기 전에 프리셋 선택

RFC 4180, Excel, TSV, Pipe 프리셋은 한 번에 다섯 가지 옵션(구분자, 줄 끝, 인용 모드, BOM, 헤더)을 설정합니다. 가장 가까운 프리셋을 먼저 선택한 다음 필요한 경우에만 개별 옵션을 조정하세요 — 이렇게 하면 한 옵션을 뒤집고 다른 옵션을 잊어버리는 일반적인 실수(예: 세미콜론으로 전환했지만 LF를 그대로 두면 Windows의 Excel-EU가 여전히 잘못 파싱)를 피할 수 있습니다.

분석에는 평탄화, 왕복에는 문자열화

대상이 Excel, Sheets 또는 일회성 분석일 때는 평탄화를 사용하세요 — 점으로 연결된 키가 가장 깔끔한 스프레드시트 레이아웃을 생성합니다. 데이터 손실 없이 CSV → JSON → CSV 왕복이 필요할 때는 문자열화를 사용하세요 — 배열과 객체가 한 셀 안에 JSON으로 살아남습니다. 내보내기 중간에 전환하고 다시 실행하는 것은 비용이 적게 듭니다. 소비자에 따라 선택하세요.

BOM은 Excel에만 사용

UTF-8 BOM은 Windows의 Excel이 인코딩을 올바르게 감지하기 위해 필요합니다. 다른 모든 파서(Python csv, Pandas, jq, PostgreSQL COPY, BigQuery)는 BOM을 무시하거나 첫 셀의 시작 부분에 떠다니는 문자로 포함시켜 컬럼 이름을 망칩니다. 파이프라인에서는 BOM을 끄고 대상이 Excel일 때만 켜세요(또는 Excel 프리셋 사용).

JSON에서 큰 ID는 문자열로 유지

Twitter snowflake ID, Discord ID, MongoDB Long 필드, K8s resourceVersion은 자바스크립트의 안전 범위(2^53 - 1)를 초과하는 64비트 정수입니다. 변환 전에 JSON 문자열로 저장하세요("id": "9007199254740993") — CSV가 숫자를 정확히 보존하는 반면, 숫자 리터럴은 JSON.parse()에 의해 자동으로 반올림됩니다.

로드하기 전 행 형식 검증

형식이 다른 행(일부 객체에 다른 객체에 없는 키가 있음)은 출력에서 빈 셀과 병합되며 도구는 스키마 노트 경고를 표시합니다. 엄격한 스키마 소비자(BigQuery, Redshift COPY)의 경우 내보내기 전에 모든 행이 동일한 키를 공유하는지 검증하거나, 파이프라인에서 누락된 값을 명시적으로 처리하세요. 먼저 입력 형태를 확인하려면 JSON 포맷터를 사용하세요.

자주 묻는 질문