CSV JSON 변환기

사용 방법

1. 변환 방향(CSV → JSON 또는 JSON → CSV)을 고르고 데이터를 ‘입력’에 붙여 넣거나 ‘파일 열기’로 .csv, .tsv, .json 파일을 불러와요. 결과는 바로 ‘출력’에 나타나요.
2. 필요하면 옵션을 바꿔요. 구분자는 자동 감지하거나 직접 지정할 수 있고, ‘첫 행을 헤더로’는 CSV 첫 행을 필드 이름으로 쓰며, ‘타입 변환’은 숫자와 true/false를 JSON 숫자와 불리언으로 바꿔요.
3. ‘복사’나 ‘다운로드’로 결과를 받아요. 엑셀에서 CSV를 열 거라면 ‘BOM 추가’를 켜 두세요. ‘바꾸기’를 누르면 출력을 입력으로 옮겨 반대로 변환해 확인할 수 있어요.

사용 예시

CSV → JSON(헤더와 타입 변환 켬): 헤더 id,name,price,active와 9007199254740993,Amy,1200.50,true, 007,Ben,300,false 두 행을 넣으면 2행 × 4열이 돼요. 300은 숫자, true와 false는 불리언이 되지만, 안전한 정수 범위를 넘는 9007199254740993, 앞자리가 0인 007, 끝자리가 0인 1200.50은 문자열로 남아 CSV로 되돌려도 그대로예요.

JSON → CSV: [{"name":"Amy","tags":["a","b"]},{"name":"Ben","email":"ben@example.com"}]를 넣으면 두 레코드 키의 합집합인 name, tags, email이 열이 되어 2행 × 3열이 돼요. Amy에는 email이, Ben에는 tags가 없어 해당 셀은 비어 있어요. tags 배열은 JSON 문자열이 되고, 쉼표와 따옴표가 있어 CSV에서는 "[""a"",""b""]"로 기록돼요.

결과 해석

• 상태 표시줄의 ‘행 × 열’은 데이터 행 수이며 헤더 행은 포함하지 않아요. CSV의 빈 줄은 건너뛰고 세지 않아요.
• ‘필드 수가 헤더와 맞지 않음’이 나오면 헤더보다 필드가 많거나 적은 행이 있다는 뜻이에요. 대부분 값에 쉼표가 있는데 따옴표로 감싸지 않은 경우예요. 필드가 부족한 행은 뒤쪽 키가 빠지고, 남는 값은 __parsed_extra에 들어가요.
• ‘타입 변환’을 끄면 JSON 값은 모두 문자열이에요. 켜더라도 숫자와 true/false만 바꾸며, 빈 셀은 빈 문자열, 날짜는 문자열 그대로예요.
• 헤더에 같은 이름이 있으면 자동으로 이름을 바꿔요. 예를 들어 a가 두 개면 a와 a_1이 되어 뒤 열이 앞 값을 덮어쓰지 않아요.

원리와 계산 방법

• CSV 파싱과 출력은 papaparse를 사용하며 따옴표 규칙은 RFC 4180을 따라요. 구분자, 따옴표, 줄바꿈이 있는 필드는 큰따옴표로 감싸고, 안의 따옴표는 두 번 써요. 출력 줄바꿈은 CRLF예요.
• 구분자 자동 감지는 쉼표, 탭, 세로줄, 세미콜론 중 각 행의 필드 수가 가장 일정한 것을 골라요. 열이 하나뿐이면 판단할 수 없어 쉼표로 처리해요.
• 타입 변환 규칙: 숫자로 바꿨다가 글자로 되돌린 결과가 원문과 똑같고, 정수라면 ±(2^53−1)의 안전 범위 안에 있을 때만 숫자로 바꿔요.
• JSON → CSV: 객체 배열은 모든 키의 합집합(처음 나온 순서)을 열로 쓰고, 2차원 배열은 한 행씩 그대로 출력하며, 값만 있는 배열은 value 열에 넣어요. 안전 범위를 넘는 정수는 파싱 전에 원래 글자를 보존하므로 반올림되지 않아요.
• 파일은 먼저 UTF-8로 읽고, 올바른 UTF-8이 아니면 Big5로 다시 읽어요.

한계와 주의점

• 평평한 표만 지원해요. 중첩 JSON을 user.name 같은 여러 열로 펼치지 않고, 객체 전체를 JSON 문자열로 한 셀에 넣어요.
• 구분자 자동 감지는 행마다 필드 수가 같다는 전제가 필요해요. 데이터가 적거나 필드 수가 들쭉날쭉하면 틀릴 수 있으니 직접 고르세요.
• 자동으로 인식하는 인코딩은 UTF-8과 Big5뿐이에요. EUC-KR 등 다른 인코딩 파일은 먼저 UTF-8로 저장해 주세요.
• 모든 데이터를 브라우저 메모리에서 처리하므로 수십 MB 이상의 파일은 페이지가 느려질 수 있어요.

자주 묻는 질문

💬 답을 찾지 못했나요? 이 도구의 문제를 신고하거나 의견을 보내 주세요