CSV와 JSON 변환 오류 고치기

문제 상황

CSV와 JSON 변환 실패는 대부분 변환기 자체보다 원본 구조 불일치에서 시작됩니다. 헤더 행, 따옴표로 감싼 쉼표, 세미콜론 구분자, 빈 셀, 숨은 BOM, 여러 줄 셀, 잘못된 JSON 배열이 모두 빠른 미리보기에서는 그럴듯해 보여도 스프레드시트, 데이터베이스, API 테스트에서는 잘못된 열이나 키를 만들 수 있습니다.

이럴 때 사용하세요

• CSV 내보내기 후 JSON 키가 누락되거나 열 값이 한 칸씩 밀릴 때 사용합니다.
• JSON payload가 배열이 아니거나 레코드 모양이 달라 CSV로 변환되지 않을 때 사용합니다.
• 이름, 주소, 설명에 쉼표나 줄바꿈이 들어 있어 셀이 여러 칸으로 쪼개질 때 적합합니다.
• 첫 번째 헤더에 이상한 문자가 붙거나 한글/일본어 텍스트가 깨져 인코딩과 BOM을 확인해야 할 때 사용합니다.
• 빈 셀, 중첩 필드, 서로 다른 열 처리를 예상과 다르게 해 스프레드시트 가져오기가 실패할 때 사용합니다.

단계

1. 1단계

   헤더 행부터 확인

   첫 번째 CSV 행이 안정적인 필드 이름인지 확인합니다. 빈 헤더, 중복 헤더, 사람이 읽기 위한 설명형 라벨은 JSON 객체 키로 쓰기 전에 정리하세요.

2. 2단계

   구분자와 따옴표 처리 확인

   이름, 주소, 설명 안에 쉼표나 줄바꿈이 있는지 확인합니다. 구분자가 들어간 값은 따옴표로 감싸야 파싱 중 열이 밀리지 않습니다.

3. 3단계

   JSON을 CSV로 되돌리기 전에 정리

   JSON에서 시작할 때는 JSON Formatter로 먼저 포맷하고 문법 오류, 배열 위치, 레코드별 키 차이를 확인한 뒤 CSV로 내보냅니다.

4. 4단계

   문자가 깨지면 인코딩 확인

   헤더나 값에 깨진 문자가 보이면 문자 인코딩과 숨은 BOM을 확인한 뒤 다시 변환합니다. 값을 하나씩 고치기 전에 원본 해석 방식을 먼저 점검하세요.

5. 5단계

   작은 샘플로 왕복 테스트

   대표 행 몇 개를 먼저 변환한 뒤, 전체 파일을 처리하기 전에 대상 스프레드시트, API 클라이언트, 데이터 파이프라인에서 다시 열어 확인합니다.

예시

id,name,note
1,Ada,"uses commas, safely"
2,Linus,"exports cleanly"

[{"id":"1","name":"Ada","note":"uses commas, safely"},{"id":"2","name":"Linus","note":"exports cleanly"}]

흔한 실수

자주 묻는 질문