CSV ↔ JSON 변환기
입력 칸에 CSV를 붙여 넣거나 파일을 열면 결과 칸에 JSON이 나오고 아래에서 표로 미리 볼 수 있습니다. JSON을 CSV로 바꾸려면 방향을 선택하세요.
첫 행을 열 이름으로 사용합니다. 값은 문자열로 유지합니다.
CSV를 붙여 넣거나 파일을 열어 주세요.
첫 행은 열 이름 · 빈 칸도 보존
표 미리보기
변환 후 첫 8행을 보여줍니다.
열 이름과 데이터가 여기에 표시됩니다.
바로 쓸 수 있게.
- 바로 보이는 화면입력 위치와 결과 위치를 또렷하게 둡니다.
- 결과 먼저핵심 결과를 앞에 두고, 과정은 필요할 때만 보여줍니다.
- 요구 줄이기가입이나 불필요한 정보 입력 없이 바로 쓰게 합니다.
CSV와 JSON 사이에서 표 구조를 옮기는 방법
CSV JSON 변환기는 쉼표로 구분한 표를 JSON 객체 배열로 바꾸거나, JSON 목록을 CSV 표로 옮기는 도구입니다. CSV의 첫 행은 열 이름이 되고 두 번째 행부터 각 행이 객체 하나가 됩니다. 상품 목록을 API에 전달할 자료로 정리하거나 JSON으로 받은 목록을 스프레드시트에서 확인할 때 사용하세요.
CSV의 값은 모두 문자열로 옮기므로 상품 코드 0012의 앞자리 0을 유지합니다. 반대 방향에서는 객체에 있는 키를 모아 열을 만들고 빠진 값과 null은 빈 셀로 채웁니다. 결과 미리보기로 열과 값을 확인한 뒤 복사하거나 다운로드하세요. 입력 내용과 파일은 변환을 위해 서버로 보내지 않고 현재 브라우저에서 처리합니다.
CSV의 행과 JSON의 객체는 어떻게 연결되나요?
CSV는 쉼표와 줄바꿈으로 표의 열과 행을 구분하는 텍스트 형식입니다. JSON 객체는 이름과 값을 짝지어 담고, 배열은 여러 항목을 대괄호 []로 묶습니다. 이 도구는 CSV의 열 이름을 객체의 키로 사용해 표 한 행과 객체 하나를 연결합니다.
- CSV는 상품 목록이나 업무 자료를 표 형태로 주고받을 때 자주 쓰입니다.
- JSON 객체 배열은 [{"이름":"민지"},{"이름":"준호"}]처럼 여러 건의 자료를 담습니다.
- 엑셀 통합 문서의 셀 색상, 수식 계산, 여러 시트는 이 변환에 포함되지 않습니다.
첫 행에 겹치지 않는 열 이름을 적으세요
이 도구는 CSV의 첫 행을 항상 열 이름으로 읽습니다. 머리글이 없는 CSV라면 맨 위에 이름을 추가하세요. 이름이 비어 있거나 같은 이름이 반복되면 어떤 값이 어느 키에 속하는지 분명하지 않아 변환을 멈춥니다. CSV 자체에서 머리글이 언제나 필수인 것은 아니며, 첫 행을 사용하는 것은 이 도구의 변환 규칙입니다.
- 상품코드,상품명,수량처럼 각 열의 의미를 첫 행에 적으세요.
- 상품명,상품명처럼 반복된 이름은 상품명,옵션명 등 실제 의미에 맞게 고치세요.
- 첫 행이 실제 데이터라면 그 행까지 열 이름이 되므로 변환 전에 머리글을 추가해야 합니다.
두 줄짜리 CSV를 JSON 한 건으로 바꾸기
첫 행이 코드,수량이고 두 번째 행이 0012,3이면 결과는 [{"코드":"0012","수량":"3"}]입니다. 머리글을 제외한 데이터가 한 행이므로 객체도 한 개입니다. 화면의 JSON은 읽기 좋게 들여쓰지만 담긴 값은 같은 문자열입니다.
- 0012는 숫자 12로 바뀌지 않고 "0012"로 남습니다.
- 3도 숫자 자료형이 아닌 문자열 "3"으로 출력합니다.
- true, false, null처럼 보이는 CSV 셀도 각각 글자로 보존합니다. 빈 셀은 빈 문자열 ""이 됩니다.
쉼표·큰따옴표·셀 안 줄바꿈을 구분합니다
주소처럼 쉼표가 들어 있는 CSV 셀은 큰따옴표로 감싸세요. 예를 들어 "서울, 성동구"는 쉼표가 있어도 하나의 값입니다. 인용된 셀 안에서 큰따옴표 자체는 두 번 적습니다. 셀 안 줄바꿈도 큰따옴표 안에 있어야 행 구분과 나누어 읽을 수 있습니다.
- CSV의 """가을"" 세트"는 값 "가을" 세트를 나타냅니다.
- 셀 안 줄바꿈은 JSON에서 \n 또는 \r\n 같은 이스케이프 표기로 나타납니다.
- 따옴표가 닫히지 않거나 인용 문법이 틀렸다면 오류 안내를 보고 원문을 고치세요.
행마다 열 수가 다르면 원문을 확인하세요
모든 데이터 행의 셀 수는 첫 행의 열 이름 수와 같아야 합니다. 이 도구는 셀이 부족한 행을 추측해서 채우거나 남는 셀을 버리지 않습니다. 예를 들어 머리글이 이름,도시,메모라면 각 데이터 행에도 셀 세 개가 필요합니다.
- 민지,서울,은 마지막 메모가 빈 문자열인 세 셀입니다.
- 민지,서울은 두 셀이므로 위의 세 열짜리 머리글과 맞지 않습니다.
- 주소 속 쉼표를 큰따옴표로 감싸지 않으면 열이 하나 더 생길 수 있습니다.
JSON은 중첩되지 않은 객체 배열을 넣으세요
JSON → CSV에서는 [{"이름":"민지","수량":3}]처럼 객체를 담은 배열을 사용합니다. 각 값에는 문자열, 숫자, 불리언, null을 넣을 수 있습니다. 객체 안에 다른 객체나 배열이 있으면 변환을 멈춥니다. 중첩 구조를 어느 열로 펼칠지 임의로 결정하지 않기 때문입니다.
- {"items":[...]} 형태의 API 응답에서는 items 안의 객체 배열을 꺼내 입력하세요.
- {"주소":{"도시":"서울"}}이나 {"태그":["신규"]}는 중첩 값이 있어 지원하지 않습니다.
- [1,2], [null], [[1,2]]처럼 바깥 배열의 항목이 객체가 아닌 자료도 지원하지 않습니다.
객체마다 키가 달라도 하나의 표로 모읍니다
모든 객체에 등장하는 키를 합쳐 CSV의 열로 사용합니다. [{"이름":"민지"},{"이름":"준호","도시":"부산"}]을 넣으면 이름과 도시 열이 생깁니다. 첫 번째 객체에 없는 도시는 빈 셀이 됩니다. JSON의 키 순서에 의미를 두는 프로그램이라면 변환 후 열 이름을 직접 확인하세요.
- 첫 번째 데이터 행은 민지,이고 두 번째 행은 준호,부산입니다.
- 한 객체에 같은 키를 반복하지 마세요. 프로그램마다 중복 키를 읽는 방식이 다를 수 있습니다.
- 빈 배열 []에는 CSV의 열로 만들 키가 없어 내려받을 파일을 만들지 않습니다.
null·빈 문자열·빠진 값은 CSV에서 구분되지 않습니다
JSON의 null, 빈 문자열 "", 해당 키가 없는 경우는 모두 빈 CSV 셀로 출력합니다. CSV에는 JSON의 자료형 정보가 따로 담기지 않으므로 다시 JSON으로 변환해도 원래 상태를 복원할 수 없습니다. 값이 없다는 이유까지 보존해야 한다면 원본 JSON을 함께 보관하세요.
- [{"값":null},{"값":""},{}]는 값 열 아래에 빈 셀 세 개로 옮겨집니다.
- JSON의 숫자 3과 불리언 true도 CSV를 거쳐 돌아오면 문자열 "3", "true"가 됩니다.
- 누락과 null을 구분해야 하는 자료는 별도 상태 열을 준비하거나 JSON 형식을 유지하세요.
긴 식별자와 정밀한 소수는 문자열로 준비하세요
JSON에 숫자로 적은 긴 정수는 브라우저가 읽을 때 값이 바뀔 수 있습니다. 이 도구는 안전한 정수 범위를 벗어나는 숫자를 거부합니다. 주문 번호나 회원 번호처럼 계산하지 않는 값은 "9007199254740993"처럼 큰따옴표로 감싸세요. 문자열은 자리수를 숫자로 해석하지 않습니다.
- 안전한 정수 범위는 -9,007,199,254,740,991부터 9,007,199,254,740,991까지입니다.
- 많은 자릿수의 소수나 1.00 같은 표기도 그대로 남겨야 한다면 문자열을 사용하세요.
- 안전한 정수 범위 검사만으로 모든 소수의 정밀도나 숫자 표기가 보존되는 것은 아닙니다.
붙여 넣거나 UTF-8 파일을 열어 변환하세요
입력 자료에 맞춰 CSV → JSON 또는 JSON → CSV를 선택하고 내용을 붙여 넣거나 파일을 여세요. 한글 파일은 UTF-8로 준비합니다. XLSX 파일은 확장자만 CSV로 바꾸지 말고 원래 프로그램에서 CSV로 내보내야 합니다.
- 입력 한도는 UTF-8 기준 5 MiB, 즉 5,242,880바이트입니다. 머리글을 포함해 최대 200,000셀, 변환 결과는 최대 10 MiB까지 처리합니다.
- 세미콜론이나 탭으로 나눈 자료는 쉼표로 구분한 CSV로 준비하세요.
- 변환할 자료가 크면 행 단위로 나누세요. CSV마다 같은 머리글을 붙이고 JSON은 각각 완전한 배열로 묶어야 합니다.
미리보기에서 머리글과 데이터 행을 비교하세요
표 미리보기는 머리글과 앞부분의 데이터 8행·8열까지 보여 줍니다. 전체 자료를 펼친 화면은 아니므로 원본의 행 수와 결과의 건수도 함께 확인하세요. CSV → JSON에서는 머리글 한 행을 제외한 데이터 행 수가 JSON 객체 수가 됩니다.
- 앞자리 0이 있는 코드, 쉼표를 포함한 주소, 빈 셀이 예상한 열에 들어갔는지 살펴보세요.
- 미리보기에 보이지 않는 뒷부분은 결과 텍스트나 내려받은 파일에서 확인하세요.
- 첫 행을 포함해 CSV가 11행이고 셀 안 줄바꿈이 없다면 데이터는 10건입니다.
복사·다운로드와 Excel용 BOM 선택
다른 입력 칸에 옮길 때는 결과 복사를, 파일로 전달할 때는 다운로드를 사용하세요. JSON은 BOM 없는 UTF-8로 저장합니다. CSV는 행 구분에 CRLF를 쓰며 Excel 호환용 UTF-8 BOM을 선택해 붙일 수 있습니다. BOM 옵션은 기본으로 꺼져 있습니다.
- BOM은 파일 앞에 붙는 인코딩 표시입니다. 이미 깨진 한글을 복원하는 기능은 아닙니다.
- CSV를 스프레드시트에 가져올 때 코드·전화번호 열은 텍스트로 지정해 앞자리 0을 확인하세요.
- = 등으로 시작하는 셀은 스프레드시트에서 수식으로 해석할 수 있습니다. 출처를 확인하고 필요하면 텍스트로 가져오세요. 이 도구가 수식형 값을 자동으로 바꾸지는 않습니다.
CSV JSON 변환 자주 묻는 질문
CSV 첫 행이 열 이름이 아니라 실제 데이터라면 어떻게 하나요?
맨 위에 열 이름을 한 행 추가한 뒤 변환하세요. 이 도구는 첫 행을 항상 JSON의 키로 읽고 두 번째 행부터 데이터로 처리합니다. 열 이름은 비어 있거나 서로 같으면 안 됩니다.
0012나 true를 넣으면 숫자와 불리언으로 바뀌나요?
CSV → JSON에서는 모두 문자열로 유지합니다. 0012는 "0012", true는 "true"가 됩니다. 숫자 3도 "3"으로 옮기므로 받는 프로그램이 숫자 자료형을 요구한다면 별도로 자료형을 정해야 합니다.
주소 안에 쉼표가 있어도 한 셀로 변환되나요?
네. "서울, 성동구"처럼 셀을 큰따옴표로 감싸면 쉼표를 값의 일부로 읽습니다. 셀 안의 큰따옴표는 두 번 적고 셀 안 줄바꿈도 큰따옴표 안에 넣으세요.
열 수가 다른 행은 빈칸으로 채워 주나요?
CSV → JSON에서는 머리글과 셀 수가 다른 행을 오류로 알립니다. 열 세 개 중 마지막 값이 없다면 민지,서울,처럼 끝의 빈 셀을 나타내세요. JSON → CSV에서는 객체에 없는 키의 값을 빈 셀로 채웁니다.
API에서 받은 중첩 JSON도 CSV로 바꿀 수 있나요?
이 도구는 중첩되지 않은 객체 배열을 지원합니다. {"items":[...]}라면 items 배열을 꺼내 입력하세요. 배열 안 객체의 값에 또 다른 객체나 배열이 있으면 변환이 멈추므로 필요한 항목을 단순한 열로 정리해야 합니다.
null과 빈 문자열을 왕복 변환하면 원래대로 돌아오나요?
아니요. JSON의 null, 빈 문자열, 빠진 키는 CSV에서 모두 빈 셀이 됩니다. 다시 JSON으로 바꾸면 빈 문자열이 되므로 원래 상태를 구분할 수 없습니다. 숫자와 불리언도 CSV를 거치면 문자열로 돌아옵니다.
9007199254740993 같은 긴 번호가 왜 거부되나요?
JSON 숫자로 넣으면 안전한 정수 범위를 벗어나므로 변환을 멈춥니다. 식별자라면 "9007199254740993"처럼 문자열로 넣으세요. 숫자로 정밀하게 계산하는 기능은 제공하지 않습니다.
미리보기에 8행만 보이면 나머지 데이터는 빠지나요?
미리보기만 앞부분의 데이터 8행·8열로 제한합니다. 정상 변환된 전체 결과는 결과 텍스트와 다운로드에 담깁니다. 머리글을 제외한 데이터 건수도 함께 확인하세요.
한글 파일과 Excel에서 사용할 CSV는 어떻게 저장하나요?
입력 파일을 UTF-8로 준비하세요. CSV 다운로드에는 Excel 호환용 BOM 옵션을 켤 수 있으며 기본값은 꺼짐입니다. 한글이 이미 깨진 원문은 원래 프로그램에서 UTF-8로 다시 저장해야 합니다. JSON 다운로드에는 BOM을 붙이지 않습니다.
변환하려고 넣은 파일이 서버에 저장되나요?
입력 내용과 파일은 현재 브라우저에서 변환하며 변환을 위해 서버로 전송하지 않습니다. 입력은 UTF-8 기준 최대 5 MiB, 5,242,880바이트이며 머리글을 포함한 셀 수는 최대 200,000개입니다.
형식 기준과 참고 자료
CSV의 따옴표·쉼표 규칙, JSON 객체의 키와 값, CSV 파일의 문자 인코딩을 각각 확인할 수 있는 1차 자료입니다. 첫 행을 헤더로 쓰고 평평한 객체만 변환하는 범위는 이 도구의 선택입니다.
함께 쓰면 좋은 도구
자료를 다른 표·텍스트 형식으로 옮겨야 할 때 필요한 도구를 골라 쓰세요.