Excel 표, 헤더 행, 중첩 필드를 위한 CSV ⇄ JSON 변환기
Excel 등에서 내보낸 CSV를 JSON 배열로, JSON을 다시 CSV로 브라우저에서 변환합니다. 첫 행이 객체 키가 되고, 중첩 객체는 점 표기 열로 평탄화되며, 배열은 한 셀 안의 JSON 문자열로 저장됩니다.
이 CSV ⇄ JSON 변환기의 실제 동작
첫 행은 항상 헤더
CSV → JSON은 1행을 필드 이름으로 쓰고 나머지 행마다 객체 하나를 만듭니다. 헤더가 없는 파일은 첫 데이터 행이 열 이름으로 소비되고, 헤더만 있으면 빈 배열을 반환합니다.
중첩 JSON은 점 표기 열로
JSON → CSV는 meta.x / meta.y 같은 열을 쓰고, 그 CSV를 다시 변환하면 중첩 객체로 복원됩니다. 단순한 구조는 정상적으로 왕복됩니다.
배열은 한 셀 안의 JSON으로
배열과 객체 배열은 [1,2,3] 같은 문자열로 저장되어 표가 직사각형으로 유지됩니다. CSV → JSON은 JSON처럼 보이는 셀을 배열이나 객체로 파싱합니다.
숫자는 추정하며 원형을 보장하지 않음
숫자 셀은 숫자가 됩니다(1.50 → 1.5, 1e5 → 100000). 007 같은 앞자리 0은 문자열로 남지만, 2^53을 넘는 ID는 정밀도를 잃고 +4는 숫자로 처리되지 않습니다.
브라우저에서 실행, 파일 업로드 없음
.csv / .json 파일을 선택하거나 붙여넣고 결과를 복사·다운로드할 수 있습니다. 변환은 동기로 실행되어 매우 큰 파일은 탭을 멈추게 할 수 있습니다.
CSV ⇄ JSON 변환 FAQ
CSV에 헤더 행이 꼭 필요한가요?
필요합니다. 첫 번째 비어 있지 않은 행이 헤더가 되고 이후 각 행이 JSON 객체 하나가 됩니다. 헤더가 없으면 첫 데이터 행이 열 이름으로 소비됩니다. 헤더만 있는 파일은 빈 배열을 반환합니다.
전화번호, 우편번호, 주문 ID를 텍스트로 유지하려면?
007 같은 앞자리 0은 자동으로 문자열로 유지되지만 1.0은 1, 1e5는 100000이 되고 2^53을 넘는 정수는 자릿수를 잃습니다. 모든 열을 텍스트로 읽는 옵션은 없으므로 원본 파일에서 인용부호를 붙이거나 미리 형식을 지정하세요.
중첩 객체와 배열은 어떻게 표현되나요?
JSON → CSV는 객체를 user.name 같은 점 표기 헤더로 평탄화하고 배열은 한 셀의 JSON 텍스트로 저장합니다. CSV → JSON은 점 표기 헤더를 다시 객체로 나누고 JSON처럼 보이는 셀을 파싱합니다. 점이 실제로 들어간 키는 a\.b로 기록되어 분리되지 않습니다.
빈 값, 인용부호, 줄바꿈, 구분자는 어떻게 되나요?
빈 셀은 빈 문자열이 됩니다. 쉼표, 인용부호, 줄바꿈은 내보낼 때 인용되고 다시 파싱됩니다. 빈 줄은 첫 열만 채워진 부분 객체를 만들고, 헤더 수를 넘는 셀은 버려지거나 위치가 어긋납니다. 쉼표 구분만 지원하며 세미콜론이나 탭 파일은 한 열로 읽힙니다.
Excel CSV에 \r\n과 BOM이 있으면 왜 깨지나요?
파서가 LF로만 분할하기 때문에 CRLF 파일은 마지막 헤더 이름에 \r이 남고, CRLF를 포함한 인용 필드가 파일 나머지를 한 셀에 삼킬 수 있습니다. UTF-8 BOM도 첫 헤더 키에 붙습니다. 변환 전에 UTF-8(BOM 없음), LF로 다시 저장하세요.
구분자를 바꿀 수 있나요?
아니요. 구분자, 인용부호, 인코딩 옵션이 없고 쉼표 구분만 파싱합니다. 세미콜론이나 탭 구분 파일은 한 열로 읽혀 행 전체가 키가 됩니다. 필요하면 먼저 쉼표 CSV로 변환하세요.
CSV → JSON → CSV는 무손실 왕복인가요?
보장되지 않습니다. 필드 순서는 유지되지만 타입 추정, 점 표기 평탄화, 배열의 JSON 문자열화, 누락 키의 리터럴 출력으로 데이터가 달라질 수 있습니다. null은 null, 누락된 키는 undefined라는 텍스트로 나갑니다. 날짜 같은 값은 항상 일반 문자열이며 JSON 편집기에서는 Date 객체를 만들 수 없어 날짜 형식화가 적용되지 않습니다. 내보내기 전에 객체 형태를 맞추세요.

