개발자 작업 흐름
스프레드시트용 CSV를 JSON으로 변환하기
스프레드시트용 CSV를 JSON으로 변환하기를 위한 실전 가이드입니다. CSV JSON 변환기를 사용해 입력 확인부터 결과 검토까지 브라우저 안에서 진행합니다.
문제 상황
급하게 처리하면 입력 범위, 인코딩, 순서, 민감한 정보, 출력 형식을 놓치기 쉽습니다. 스프레드시트용 CSV를 JSON으로 변환하기에서는 CSV JSON 변환기를 사용해 로컬에서 확인하며 공유 전 문제를 줄입니다.
이럴 때 사용하세요
- 스프레드시트 내보내기 결과를 API 요청 본문에 붙여 넣어야 할 때 사용합니다.
- 제품 목록이나 고객 목록을 JSON fixture로 만들어야 할 때 적합합니다.
- CSV 파일을 내부 도구로 가져오기 전에 헤더와 빈 셀을 확인해야 할 때 도움이 됩니다.
- Excel, Google Sheets, 지역 설정에서 나온 CSV의 구분자와 인코딩을 변환 전에 확인해야 할 때 사용합니다.
단계
- 1단계
헤더 행 확인
첫 행이 JSON key가 될 수 있는 안정적인 필드 이름으로 구성되어 있는지 확인합니다.
- 2단계
CSV를 JSON으로 변환
CSV를 붙여 넣고 각 행이 구조화된 record가 되도록 객체 배열 형태로 변환합니다.
- 3단계
빈 셀과 숫자처럼 보이는 값 확인
빈 셀을 빈 문자열, 명시적인 빈 값 표시, 제거된 필드 중 무엇으로 둘지 정하고, ID나 우편번호는 문자열 유지가 필요한지 확인합니다.
- 4단계
JSON 결과 포맷팅
테스트, 예시, API 디버깅에 쓰기 전에 JSON 출력을 보기 좋게 정리합니다.
- 5단계
사용할 API나 fixture와 대조
생성된 key, 필수 필드, 데이터 타입, 행 수가 실제 요청 본문이나 테스트 fixture 규칙과 맞는지 비교합니다.
예시
스프레드시트용 CSV를 JSON으로 변환하기 예시
입력
id,email,plan
42,dev@example.com,pro
43,ops@example.com,starter출력
[
{
"id": "42",
"email": "dev@example.com",
"plan": "pro"
},
{
"id": "43",
"email": "ops@example.com",
"plan": "starter"
}
]흔한 실수
사람이 읽는 라벨을 API key로 사용
Customer Email 같은 헤더는 fixture를 만들기 전에 customerEmail 또는 email처럼 안정적인 key로 바꾸세요.
따옴표 안의 쉼표를 무시
주소, 이름, 설명에는 쉼표가 들어갈 수 있습니다. 변환기는 따옴표로 감싼 CSV 셀을 무작정 나누지 않고 보존해야 합니다.
스프레드시트 수식을 그대로 둔 채 변환하는 경우
CSV 내보내기는 저장 방식에 따라 계산된 값이나 수식 문자열을 포함할 수 있습니다. JSON fixture나 API 예제로 변환하기 전에 수식 열을 먼저 검토하세요.
CSV 내보내기 방식을 확인하지 않는 경우
Excel, Google Sheets, 지역 설정에 따라 구분자, 따옴표 문자, 줄바꿈, 인코딩이 달라질 수 있습니다. JSON 결과를 판단하기 전에 해당 설정을 입력 파일과 맞추세요.
비공개 스프레드시트 열까지 가져오는 경우
내보내기에는 메모, 내부 ID, 숨겨진 열, 임시 검토 필드가 포함될 수 있습니다. API나 fixture에 필요 없는 열은 변환 전에 제거하세요.
자주 묻는 질문
CSV 숫자는 JSON 숫자로 바꿔야 하나요?
API 규칙에 따라 다릅니다. ID, 우편번호, 계정번호는 앞자리 0이 중요할 수 있어 문자열로 두는 편이 안전한 경우가 많습니다.
CSV가 세미콜론을 쓰면 어떻게 하나요?
일부 스프레드시트 내보내기는 locale 설정에 따라 세미콜론을 사용합니다. 변환 전에 파일에 맞는 구분자를 선택하세요.
CSV로 중첩 JSON을 표현할 수 있나요?
CSV는 기본적으로 평평한 구조입니다. 중첩 JSON은 보통 기본 변환 후 별도의 매핑 규칙이나 후처리가 필요합니다.
중복 CSV 헤더는 어떻게 처리해야 하나요?
변환 전에 중복 헤더를 바꾸세요. JSON 객체는 같은 키를 가진 필드 두 개를 안정적으로 유지할 수 없으므로 billingEmail, shippingEmail처럼 명확한 이름으로 나누는 것이 좋습니다.
빈 셀은 JSON에서 어떻게 표현해야 하나요?
변환 전에 빈 값을 빈 문자열, 명시적인 빈 값 표시, 생략된 필드 중 무엇으로 둘지 정하세요. 정답은 JSON을 소비할 API나 fixture 규칙에 따라 달라집니다.
가져오기 전에 변환된 JSON을 어떻게 검증하나요?
JSON을 사용하기 전에 행 수, 필수 key, 데이터 타입, 중복 헤더, 스프레드시트 앞뒤의 몇 가지 edge row를 확인하세요.