CSV / Excel ⇄ JSON
표 가져오기 · JSON 내보내기 · 헤더 인식
CSV / Excel
준비됨
ABOUT
CSV / Excel ⇄ JSON 소개
CSV 또는 Excel 표를 JSON 배열로 변환, 또는 JSON을 CSV로 내보내기. 데이터 가져오기/내보내기가 용이합니다.
운영·영업·재무가 제공하는 Excel은 API 연동 테스트의 1차 「실데이터」인 경우가 많습니다. 로컬 파싱으로 고객 명단·주문 상세를 제3자 변환 사이트에 업로드하지 않아 컴플라이언스 팀도 안심할 수 있습니다.
DEEP DIVE
CSV / Excel ⇄ JSON 자세히 알아보기
CSV와 Excel은 업무 담당자에게 가장 익숙한 데이터 형식이고, API와 데이터베이스는 보통 JSON을 사용합니다. JSONSort CSV/Excel 도구는 표와 JSON 배열 양방향 변환을 지원하며 헤더를 자동으로 JSON 키 이름에 매핑. 운영 제공 표를 빠르게 프로그램 가독 구조로 변환할 수 있습니다.
Excel .xlsx 파일은 브라우저 로컬에서 파싱 가능. 클라우드 표 서비스 업로드 불필요, 업무 데이터 프라이버시 보호.
CSV에는 단일 표준이 없습니다: 구분자는 쉼표, 세미콜론, Tab일 수 있고 인용 규칙도 Excel 내보내기와 Unix cut 사이에서 다릅니다. 가져온 후 처음 몇 줄 JSON을 반드시 미리보고 열 이름과 타입이 예상과 일치하는지 확인한 뒤 스크립트나 DB에 기록하세요.
FEATURES
핵심 기능
CSV → JSON
첫 행을 헤더로, 각 행을 JSON 객체로 변환해 배열로 출력합니다.
JSON → CSV
JSON 배열을 평탄화해 표로 만들어 비기술자에게 내보내기 용이.
Excel 가져오기
.xlsx / .xls 파일 드래그 앤 드롭 가져오기 지원.
구분자 인식
쉼표, 탭 등 일반적인 CSV 구분자 자동 처리.
즉시 미리보기
CSV 붙여넣으면 즉시 JSON 배열 구조 확인.
로컬 파싱
표 데이터 미업로드, 고객 정보 포함 업무 표에 적합.
타입 추론
숫자·불리언 문자열 자동 인식, 하류 parseInt 작업 감소.
JSON 평탄 내보내기
중첩 JSON 배열을 평탄 CSV로 내보내 Excel에서 열기.
HOW TO USE
사용 방법
-
1
CSV 붙여넣기 또는 .xlsx 파일 업로드
-
2
헤더와 구분자 확인
-
3
JSON 복사 또는 CSV 내보내기
-
4
변환 실패 시 오류 메시지 확인, 소스 파일 구문 수정 후 재시도
-
5
포맷터로 결과 정리, 또는 하류 스크립트용으로 내보내기
WORKFLOW
일반적인 워크플로
가져오기부터 결과 내보내기까지의 전체 흐름. 팀에서 CSV / Excel ⇄ JSON 사용법을 통일할 수 있습니다.
표 준비
Excel을 CSV UTF-8로 다른 이름 저장, 또는 .xlsx 직접 드래그.
JSON 미리보기
첫 레코드의 키 이름과 값 타입이 올바른지 확인.
정리(선택)
병합·정리로 빈 열 제거, 또는 포맷으로 가독성 향상.
하류로 가져오기
JSON을 Postman, 스크립트, Mock 도구에 복사.
USE CASES
적용 시나리오
데이터 엔지니어링
운영 Excel 내보내기를 JSON으로 변환해 ETL 파이프라인에 가져오기.
백엔드 개발
CSV 사용자 데이터 일괄 가져오기, JSON 구조 미리보기 후 DB 스크립트 작성.
프론트엔드 개발
제품 제공 CSV 샘플을 JSON으로 변환해 Mock 데이터 소스로 사용.
테스트 엔지니어
테스트 케이스 CSV를 JSON으로 변환해 자동화 테스트 프레임워크 구동.
성장 운영
캠페인 신청 Excel을 JSON으로 변환해 마케팅 자동화 시스템에 가져오기.
재무 대조
은행 CSV 명세를 JSON으로 변환해 내부 대조 API 연동.
TIPS
사용 팁
- CSV 첫 행은 헤더여야 합니다. 그렇지 않으면 키 이름이 col1, col2 등 기본 이름이 됩니다.
- 필드에 쉼표가 포함되면 큰따옴표로 감싸야 합니다. 그렇지 않으면 열이 잘못 분리됩니다.
- Excel 다중 sheet 파일은 현재 첫 sheet를 파싱. 대상 sheet를 미리 내보내세요.
- JSON → CSV는 API 반환 배열을 제품/운영이 확인하기 위한 내보내기에 적합.
- 변환 후 포맷터로 확인해 숫자가 문자열로 잘못 파싱되지 않았는지 검증.
- 큰 표는 먼저 몇 줄로 열 매핑을 검증한 뒤 전체 파일 처리.
- Windows Excel CSV 내보내기는 GBK일 수 있음. UTF-8로 다른 이름 저장 후 가져오기 권장.
- 날짜 열은 종종 문자열로 인식. 하류에서 locale에 따라 파싱 필요.
- 빈 행은 건너뜀. 전체 빈 행으로 구분된 블록은 수동 정리가 필요할 수 있음.
- JSON 배열이 클 때 CSV 내보내기는 Excel 104만 행 상한에 주의.
LOCAL VS ONLINE
로컬 vs 온라인 도구
JSONSort는 순수 프론트엔드 아키텍처를 고수합니다. 아래 비교가 개발 데이터 처리에 로컬 도구가 적합한 이유를 보여줍니다.
TROUBLESHOOTING
흔한 오해 및 문제 해결
실제 사용에서 자주 발생하는 문제와 권장 대처법. 시행착오 시간을 줄입니다.
열 어긋남
권장:필드 내 쉼표가 큰따옴표로 감싸지지 않음. Excel에서 수정하거나 수동으로 인용부 추가.
한글 깨짐
권장:파일이 UTF-8 인코딩인지 확인. Excel 가져오기 시 UTF-8 CSV 선택.
숫자가 문자열로
권장:선행 0이나 너무 긴 숫자는 문자열로 유지. 하류에서 명시적 타입 변환.
sheet 불일치
권장:현재 첫 sheet만 파싱. 대상 sheet를 미리 내보내세요.
FAQ
자주 묻는 질문
Excel 수식 셀은 어떻게 처리?
셀 표시값(계산 결과)을 읽으며 수식 자체는 아님.
빈 셀은 무엇이 되나?
보통 빈 문자열 "" 또는 null. 열 타입 추론에 따라 다름.
UTF-8 BOM CSV 지원?
지원. BOM 헤더 자동 인식, 다국어 콘텐츠 올바르게 처리.
커스텀 구분자 지정 가능?
일반적인 구분자 자동 인식. 실패 시 Tab을 쉼표로 변환 후 붙여넣기.
헤더 없이 가능?
헤더 없으면 col1, col2 등 기본 열 이름 생성. 항상 헤더 행 제공 권장.
데이터가 서버에 업로드되나?
아니요. JSONSort 모든 도구는 브라우저 로컬에서 동작하며 입력 내용은 백엔드 서버로 전송되지 않습니다.
가입이나 설치가 필요한가?
필요 없습니다. 페이지를 열면 바로 사용 가능, 계정·클라이언트 다운로드 불필요, PWA 오프라인 캐시 지원.
얼마나 큰 파일을 지원하나?
브라우저 메모리에 따라 다르지만 보통 수 MB급 데이터를 원활히 처리합니다. 초대형 파일은 먼저 분할하거나 병합·정리 도구를 사용하세요.