← JSON 도구로 돌아가기

CSV를 JSON으로 변환

최종 업데이트: 2026년 10월 1일

CSV 표를 JSON 객체 배열로 되돌립니다. 헤더 행이 키가 되고, 읽을 때 RFC 4180 따옴표 규칙을 이해하며, 형식 자동 감지는 켤지 여부를 선택할 수 있습니다. 모든 처리는 브라우저 안에서 이루어지며 표는 기기를 떠나지 않습니다.

이 변환이 하는 일

CSV는 열 이름을 첫 줄에 두므로 변환은 직접적인 대응입니다. 헤더 칸이 속성 이름이 되고, 그 뒤의 각 줄이 배열의 객체 하나가 됩니다. 다음 표는

id,name
1,Ada
2,Grace

[{"id":"1","name":"Ada"},{"id":"2","name":"Grace"}]가 됩니다. 값이 모두 문자열이라는 점에 주목하세요. 이것이 기본 동작이며 이유는 다음 절에서 설명합니다.

헤더 행이 스키마가 됩니다

첫 줄은 데이터가 아니라 헤더로 취급됩니다. 다음 두 가지 경계 상황은 놀라움으로 남기지 않고 처리합니다.

• 이름 중복——반복된 헤더는 고유하게 만듭니다. a,a는 a와 a_2가 됩니다. 이 처리가 없으면 둘째 열이 첫째 열을 조용히 덮어씁니다.
• 이름이 빈 경우——빈 헤더 칸은 위치로 이름을 붙입니다. column 1, column 2처럼 되어 키가 빈 문자열이 되지 않습니다.

형식 자동 감지는 기본적으로 꺼져 있습니다——의도적입니다

CSV에는 형식이 없습니다. 모든 칸이 텍스트이고, 파일 자체는 숫자와 우연히 숫자인 코드를 구분하지 못합니다. 그래서 감지가 기본적으로 꺼져 있습니다. 끈 상태에서는 모든 값이 문자열로 유지되며, 이것이 파일에 충실한 해석입니다.

켜면 모호하지 않은 것만 변환합니다. JSON 숫자로 쓸 수 있는 값——선택적 음수 부호, 숫자, 선택적 소수부와 지수——만 숫자로 보고, true, false, null은 그 자체로 인식합니다. 중요한 점은 앞에 0이 있는 값은 변환하지 않는다는 것입니다. 007과 02139는 거의 항상 식별자——우편번호, 전화번호, 계정 번호, 상품 SKU——이기 때문입니다. 무턱대고 숫자로 바꾸면 007이 조용히 7이 되어 데이터가 망가지지만, 이 규칙은 그러지 않습니다.

따옴표로 감싼 필드, 내장 쉼표와 줄바꿈

읽기는 RFC 4180을 따릅니다. JSON을 CSV로 변환하는 페이지가 쓸 때 쓰는 것과 같은 규칙입니다. 큰따옴표로 감싼 필드는 구분자, 줄바꿈, 또는 두 번 쓴 큰따옴표(읽을 때 하나가 됨)를 담을 수 있습니다. 따라서 "Ada, Countess"는 쉼표를 포함한 하나의 값이고, 두 줄에 걸친 값도 한 칸으로 남습니다. CRLF와 LF 줄바꿈을 모두 받으며, 맨 앞의 UTF-8 바이트 순서 표시——Excel과 일부 내보내기 도구가 붙이는 보이지 않는 U+FEFF——는 제거되어 첫 열 이름이 id가 되는 일이 없습니다.

길이가 맞지 않는 행

손으로 편집한 파일이 반듯한 직사각형인 경우는 드뭅니다. 필드가 헤더보다 적은 행은 빈 값으로 채우고, 많은 행은 잘라내므로 모든 객체가 같은 키를 가집니다. 다른 선택——파일 전체를 거부하는 것——보다 형식이 맞는 행을 돌려주는 편이 유용하지만, 빠진 값이 출력에 없다는 점은 사실입니다.

자주 묻는 질문