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

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

// Input CSV (comma + LF, header on, infer types on)
id,name,active,score
1,Alice,true,98.5
2,Bob,false,87
3,Carol,true,

// Output JSON
[
  { "id": 1, "name": "Alice", "active": true, "score": 98.5 },
  { "id": 2, "name": "Bob", "active": false, "score": 87 },
  { "id": 3, "name": "Carol", "active": true, "score": null }
]

// Same input with Header off (no first-row keys)
1,Alice,true,98.5
2,Bob,false,87

// Becomes
[
  { "col1": 1, "col2": "Alice", "col3": true, "col4": 98.5 },
  { "col1": 2, "col2": "Bob", "col3": false, "col4": 87 }
]

주요 기능

예시

id,name,email,role
1,Alice,alice@example.com,admin
2,Bob,bob@example.com,editor
3,Carol,carol@example.com,viewer
4,Dan,dan@example.com,viewer

ts	event	user	duration
2026-05-09T10:00:00Z	signup	alice	142
2026-05-09T10:01:00Z	login	alice	87
2026-05-09T10:02:00Z	checkout	alice	312
2026-05-09T10:03:00Z	logout	alice	44

id;name;price
1;Alice;1234,56
2;Bob;9876,54
3;Carol;42,00

name,role,note
"Smith, Jr.",admin,"He said ""hi"""
"Doe, Jane",editor,"Two
lines"

id,event,user
9007199254740993,signup,alice
9007199254740994,login,bob
9007199254740995,checkout,carol

1,Alice,admin
2,Bob,editor
3,Carol,viewer
4,Dan,viewer

사용 방법

1. 1

   CSV 붙여넣기

   위 입력 필드에 CSV를 입력하거나 붙여넣으세요. 도구는 쉼표, 세미콜론, 탭, 파이프로 구분된 데이터를 받아들입니다. '예시 불러오기'를 클릭하여 스프레드시트 내보내기, TSV 로그, 세미콜론을 사용하는 Excel-EU CSV 같은 샘플을 사용해 볼 수도 있습니다.

2. 2

   구분자 선택(또는 Tab)

   한 번의 클릭으로 구분자를 전환하려면 `,`(기본값), `;`(Excel-EU 세미콜론), `\t`(TSV) 또는 `|`(Pipe)를 클릭하세요. 세밀한 제어를 위해 옵션 패널을 여세요: 헤더 켜기/끄기와 타입 추론 켜기/끄기. 헤더 끄기는 컬럼을 col1, col2, col3로 자동 명명합니다.

3. 3

   JSON 복사 또는 다운로드

   복사를 클릭하여 JSON을 클립보드에 저장하거나 다운로드를 클릭하여 코드, API 또는 파이프라인에서 바로 사용할 수 있는 .json 파일로 저장하세요. 왕복 변환을 위해 방향 전환을 클릭하면 그 자리에서 JSON을 다시 CSV로 변환합니다.

일반적인 변환 함정

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

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

// Wrong delimiter (default comma) on Excel-EU file
id;name;price
1;Alice;1234,56
// Each row becomes one column: { col1: "1;Alice;1234,56" }

// Correct: pick `;` Delimiter chip
id;name;price
1;Alice;1234,56
// Output: { id: 1, name: "Alice", price: "1234,56" }

// Without big-int detection
{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

// With Infer types on, big integers stay as strings
{"id": "9007199254740993"}
// Use BigInt(value) in code to preserve precision

id, name, email
1, Alice, alice@example.com
// Output keys: "id", " name", " email" (with leading spaces)

id,name,email
1,Alice,alice@example.com
// Output keys: "id", "name", "email" (clean)

name,role,note
Alice,admin
Bob,editor,first day
// Row 1 is short by one cell

// Output (note empty/null cell in row 1)
[
  { "name": "Alice", "role": "admin", "note": null },
  { "name": "Bob", "role": "editor", "note": "first day" }
]

// Expecting a Date object in the output
ts,event
2026-05-09T10:00:00Z,signup
// Output ts is the string "2026-05-09T10:00:00Z", NOT a Date

// Correct: parse at the point of use in your code
const rows = JSON.parse(output);
const when = new Date(rows[0].ts);
// when is now a Date object

주요 사용 사례

스프레드시트 내보내기를 API 가져오기로

Excel, Google Sheets 또는 Numbers에서 내보낸 CSV를 붙여넣어 REST API에 POST하거나, GraphQL 변이, 대량 가져오기 엔드포인트에 바로 사용할 수 있는 객체의 JSON 배열을 받으세요. 가장 일반적인 사용 사례입니다 — 분석가가 스프레드시트 데이터를 생성하고, 엔지니어는 백엔드를 공급하기 위해 타입 지정된 JSON이 필요합니다.

Excel 내보내기를 도구로

Excel CSV 내보내기(`;` 칩이 있는 Excel-EU 세미콜론 구분 파일 포함)를 자바스크립트 도구, jq 스크립트 또는 JSON을 읽는 모든 시스템으로 처리하기 위한 JSON으로 변환합니다. 파서는 BOM 제거와 CRLF 줄 끝을 올바르게 처리하므로 Excel 내보내기가 첫 행에서 깨지지 않습니다.

TSV 로그를 분석으로

BigQuery 내보내기, Snowflake 언로드, Vector 파이프라인 또는 Unix 도구(cut, awk)의 탭 구분 로그는 종종 .tsv로 도착합니다. Tab 구분자 칩을 선택하고 임시 분석, 대시보드 수집 또는 파이프라인 단계 변환에 바로 사용할 수 있는 타입 지정된 JSON 배열을 받으세요.

데이터베이스 CSV 덤프를 ETL로

PostgreSQL COPY TO CSV 출력, MySQL SELECT INTO OUTFILE 또는 모든 데이터베이스 CSV 덤프를 NoSQL 저장소에 로드, 자바스크립트 ETL 파이프라인 공급, 또는 BigQuery에 줄 구분 JSON으로 보내기 위한 JSON으로 변환합니다. 큰 정수 감지는 자바스크립트의 안전 범위를 초과하는 숫자 ID를 보존합니다.

Postman/Newman CSV 테스트 결과 소비

Postman 테스트 실행은 요청별 통과/실패의 CSV 보고서를 내보냅니다. 프로그래밍 방식 소비를 위해 JSON으로 변환하세요 — 상태 대시보드, 알림 파이프라인 또는 테스트 결과 집계기로 공급. 형식이 다른 행(실패한 테스트는 추가 error 컬럼이 있음)은 빈/null 채우기로 처리됩니다.

작은 CSV를 빠른 JSON 설정으로

통화 코드, 국가 이름, 제품 SKU 같은 작은 CSV가 있고 설정 파일이나 자바스크립트 상수를 위한 JSON 배열이 필요하신가요? 붙여넣고, 복사하고, 붙여넣으세요. 타입 추론 켜기를 사용하면 숫자와 불리언이 올바르게 타입 지정됩니다; 헤더 켜기를 사용하면 .json 파일에 바로 넣을 수 있는 명명된 필드 객체의 배열을 얻습니다.

기술 세부 정보

RFC 4180 상태 머신 파서 내부

파서는 RFC 4180을 따르는 적절한 유한 상태 머신 구현입니다. 상태에는 UnquotedField, QuotedField, AfterQuote, RowEnd, EndOfInput이 포함됩니다. 파서는 구분자를 포함하는 인용된 필드, 인용된 필드 안에 내장된 CR/LF, 이스케이프된 큰따옴표(""처럼 두 번 작성), 후행 개행을 올바르게 처리합니다. 이는 Python의 csv 모듈, PostgreSQL COPY, AWS S3 SELECT, 모든 호환 파서를 통해 손실 없이 왕복하는 출력을 생성합니다. 상태 머신은 구분자를 인식하므로 `,`에서 `;` 또는 `\t`로 전환해도 인용 의미는 변경되지 않습니다 — 필드 구분자만 변경됩니다.

타입 추론 알고리즘

타입 추론 켜기를 사용하면 각 셀이 순서가 지정된 감지 파이프라인을 거칩니다. 첫째, 빈 셀은 JSON null이 됩니다. 둘째, 리터럴 문자열 true와 false는 JSON 불리언이 됩니다. 셋째, 선행 0 문자열(^0[0-9]+$)은 식별자 의미를 보존하기 위해 문자열로 유지됩니다 — 숫자로 변환하면 선행 0이 조용히 제거됩니다. 넷째, 정수 리터럴이 안전 정수 경계(-2^53+1에서 2^53-1)에 대해 테스트됩니다; 이 범위를 벗어나는 값은 IEEE 754 정밀도 손실을 피하기 위해 문자열로 유지됩니다. 다섯째, ISO 8601 날짜 문자열은 정규식으로 감지되어 의도적으로 문자열로 유지됩니다 — JSON에는 기본 날짜 타입이 없습니다. 다섯 가지 가드를 모두 통과하는 것은 Number()를 통해 변환되거나(숫자) 문자열로 유지됩니다(그 외 모든 것).

BOM 제거와 인코딩 처리

모든 입력은 UTF-8로 처리됩니다. 선택적 UTF-8 BOM(0xEF 0xBB 0xBF)은 존재할 때 첫 행의 첫 셀에서 조용히 제거됩니다 — 이렇게 하면 BOM 바이트가 첫 컬럼 이름의 시작 부분에 떠다니는 문자로 포함되는 것을 방지합니다(Windows의 Excel은 일반적으로 BOM을 출력하여 단순한 파서를 깨뜨립니다). 기타 인코딩(Windows-1252, ISO-8859-1)은 자동 감지되지 않습니다; 텍스트가 이 도구에 도달할 때쯤이면 브라우저 File API가 이미 바이트를 UTF-8로 디코딩했을 것입니다. UTF-8이 아닌 입력이 있는 경우 붙여넣기 전에 iconv 또는 편집기의 인코딩 내보내기 옵션으로 먼저 변환하세요.

모범 사례

쉼표가 아닌 데이터에는 구분자를 명시적으로 선택

자동 감지에 의존하지 마세요. CSV가 세미콜론(Excel-EU), 탭(BigQuery, Snowflake 또는 Unix 도구의 TSV) 또는 파이프(쉼표가 많은 필드)를 사용한다면 붙여넣기 전에 일치하는 구분자 칩을 클릭하세요. 파서는 구분자를 인식합니다: 칩을 전환하면 입력이 즉시 다시 파싱됩니다. 이렇게 하면 파서가 잘못된 구분자를 사용하여 모든 행이 한 셀로 축소되는 가장 일반적인 CSV-to-JSON 실패 모드를 피할 수 있습니다.

타입 지정된 JSON을 위해 타입 추론 켜기 유지

타입 추론 켜기(기본값)를 사용하면 타입 지정된 JSON을 얻습니다: 숫자는 숫자로, 불리언은 불리언으로, 빈 셀이 나타나는 곳에 null. 이는 대부분의 소비자가 원하는 것입니다 — API, 프론트엔드, 자바스크립트 코드. 다운스트림 타입 엄격 소비자, 정확한 원본 바이트를 비교하는 검증 파이프라인 등 모든 셀을 문자열로 보존해야 하는 경우에만 타입 추론을 끄세요. 감지 파이프라인에는 선행 0 문자열, 큰 정수, ISO 날짜에 대한 가드가 있으므로 추론이 켜져 있어도 식별자와 날짜가 안전하게 유지됩니다.

업스트림 CSV에서 ID를 문자열로 인용

CSV가 사용자가 제어하는 데이터베이스나 파이프라인에서 생성된다면, 큰 숫자 ID(Twitter snowflake, Discord ID, K8s resourceVersion)를 인용된 CSV 문자열("9007199254740993")로 출력하여 타입 추론을 깔끔하게 통과하도록 하세요. 파서는 어쨌든 이를 문자열로 유지합니다(큰 정수 감지가 2^53 - 1을 초과하는 값을 잡아냄), 하지만 명시적인 인용은 가장 견고한 업스트림 계약이며 정밀도에 대한 모호함을 피합니다.

헤더 행은 첫 줄이어야 함

헤더 켜기(기본값)는 첫 행을 컬럼 이름으로 자동 감지합니다. CSV에 헤더 앞에 주석, 빈 줄 또는 메타데이터가 있다면 붙여넣기 전에 제거하세요 — 파서는 선행 비데이터 줄을 건너뛰지 않습니다. 헤더 없는 CSV(원시 내보내기, 머신 생성 덤프)의 경우 헤더를 끄면 컬럼이 col1, col2, col3 순서로 자동 명명됩니다. 헤더 없는 파일에 하나를 앞에 추가하여 헤더를 위조하려고 하지 마세요; 헤더를 끄거나 원본을 수정하세요.

CSV → JSON → CSV 왕복에는 문자열화 모드 사용

양방향(CSV → JSON → CSV)을 통해 데이터를 왕복할 계획이라면 역방향(JSON → CSV)은 중첩된 배열이나 객체가 손실 없이 살아남기 위해 문자열화 모드가 필요합니다. 역방향의 평탄화 모드는 CSV 파서가 완벽하게 재구성할 수 없는 점으로 연결된 키(customer.address.city)를 출력합니다. 전체 역방향 참조와 왕복 테스트 노트는 JSON to CSV 변환기를 참조하세요.

자주 묻는 질문