JSON → CSV 변환

엑셀에서 한글이 깨지는 이유와 BOM

이 도구를 쓰는 사람이 가장 많이 겪는 문제입니다. 변환은 잘 됐는데 엑셀로 열면 물음표나 "占쏙옙" 같은 글자가 나옵니다.

원인은 엑셀에 있습니다. 윈도우 한국어판 엑셀은 CSV 파일을 열 때 UTF-8이라고 가정하지 않고 시스템 기본 인코딩(CP949)으로 읽습니다. UTF-8로 저장된 한글 3바이트를 CP949 표로 읽으니 깨지는 것입니다.

해결책이 BOM입니다. 파일 맨 앞에 EF BB BF(U+FEFF) 세 바이트를 붙여 두면 엑셀이 UTF-8이라고 알아봅니다. "엑셀 호환 UTF-8 BOM" 옵션이 이 일을 합니다.

휴대폰번호 앞 0이 사라지는 문제

01012345678이 엑셀에서 1012345678이 되고, 카드번호 16자리가 1.2346E+15로 바뀌는 그 문제입니다. CSV는 값의 타입 정보가 없는 순수 텍스트라, 엑셀이 열면서 "숫자처럼 생겼으니 숫자"라고 제멋대로 판단하기 때문입니다.

이 도구의 CSV → JSON 방향은 이 함정을 피하도록 만들어져 있습니다.

• 0으로 시작하는 값(01012345678, 04524 같은 우편번호)은 숫자로 바꾸지 않고 문자열로 둡니다.
• 16자리 이상 숫자(카드번호·일부 계좌번호)도 문자열로 둡니다. 자바스크립트 숫자로 담으면 정밀도를 잃기 때문입니다.
• true/false/null 은 각각 불리언·null로 변환합니다. "숫자·불리언 자동 인식"을 끄면 모든 값이 문자열로 남습니다.

중첩 JSON 평탄화 — 점 표기의 규칙

API 응답은 대개 중첩돼 있는데 CSV는 평평한 표라, 중첩을 어떻게든 펼쳐야 합니다. "중첩 평탄화"를 켜면 경로를 점으로 이어 열 이름을 만듭니다.

• 배열은 인덱스가 키가 됩니다. 태그.0, 태그.1 처럼 됩니다. 항목 수가 행마다 다르면 열이 그만큼 늘어납니다.
• 평탄화를 끄면 중첩 객체는 JSON 문자열 그대로 한 셀에 들어갑니다. 원본 구조를 보존해야 할 때 쓰세요.
• CSV → JSON 방향에서 평탄화를 켜면 반대로 점이 있는 열 이름을 다시 중첩 객체로 복원합니다. 왕복이 됩니다.
• 행마다 키가 다르면 모든 행의 키를 모아 열을 만들고, 없는 값은 빈 칸으로 둡니다.

{ "주문번호": "A-0042",
  "고객": { "이름": "홍길동", "연락처": "010-1234-5678" },
  "태그": ["신규", "VIP"] }

→ 열: 주문번호 | 고객.이름 | 고객.연락처 | 태그.0 | 태그.1

따옴표·쉼표·줄바꿈이 든 값

CSV에서 값 안에 구분자가 들어가면 표가 어긋납니다. 그래서 RFC 4180 규칙에 따라 큰따옴표로 감싸고, 값 안의 큰따옴표는 두 번 반복해 표시합니다. 이 도구는 자동으로 처리합니다.

• 구분자를 세미콜론(;)으로 바꾸면 유럽 지역 설정의 엑셀에서 바로 열립니다. 한국어 윈도우는 쉼표가 기본입니다.
• 탭(TSV)을 고르면 저장 시 확장자도 .tsv 가 됩니다. 값에 쉼표가 많은 데이터(주소·상품명)는 TSV가 덜 지저분합니다.
• 줄 끝은 CRLF로 씁니다. 엑셀·윈도우 호환을 위한 CSV 표준입니다.

입력 형태와 한계

표로 만들려면 "객체들의 배열"이어야 열 이름이 나옵니다. 다만 실제 API 응답이 그렇게 깔끔한 경우가 드물어서, 몇 가지는 알아서 맞춰 줍니다.

• { "data": [ … ] } 처럼 배열을 감싼 형태 — 배열인 키가 정확히 하나면 그 배열을 자동으로 꺼내 씁니다. 배열 키가 둘 이상이면 어느 쪽인지 알 수 없어 객체 하나짜리 표가 됩니다.
• 객체 하나만 있는 JSON — 1행짜리 표로 만듭니다.
• .json / .csv / .tsv 파일을 드래그해 놓으면 확장자를 보고 변환 방향과 구분자를 자동으로 맞춥니다. 최대 8MB이고, 브라우저 안에서만 읽으므로 업로드되지 않습니다.