JSON ↔ CSV
JSON 배열·JSON Lines(.jsonl)와 CSV를 서로 변환합니다. 줄마다 JSON이 하나씩 든 JSON Lines는 자동으로 알아보고, CSV는 JSON 배열이나 JSON Lines로 바꿉니다. 따옴표·쉼표 이스케이프를 자동 처리하며 결과를 복사·다운로드할 수 있습니다.
내 기기 안에서만 처리돼요. 서버로 전송하지 않아요.
관련 도구
자주 묻는 질문
객체마다 키가 다르면 어떻게 되나요?
열 이름은 배열의 첫 번째 객체를 기준으로 정해집니다. 뒤쪽 객체에만 있는 키는 열이 만들어지지 않아 값이 빠지고, 첫 객체에는 있는데 뒤 객체에 없는 키는 빈 칸으로 채워집니다. 키 구성이 제각각인 데이터라면 첫 항목에 모든 키를 넣어 두는 편이 안전합니다.
값 안에 객체나 배열이 들어 있어도 되나요?
중첩된 구조를 표로 펴 주지는 않습니다. 값이 다시 객체나 배열이면 한 칸 안에 뜻을 알기 어려운 문자열로 들어가므로, 필요한 값만 한 단계 구조로 미리 정리한 뒤 변환해 주세요. 중첩 구조를 눈으로 확인하는 데는 'JSON Pretty'가 편하고, 중첩 객체를 '주소.시' 같은 열로 펼쳐 엑셀로 만들려면 '엑셀 JSON 변환'을 쓰면 됩니다.
CSV에서 JSON으로 바꾸면 숫자가 문자열로 나옵니다.
CSV에는 자료형 정보가 없어 모든 칸을 문자열로 읽습니다. 숫자나 참·거짓으로 바꿔 주는 처리는 하지 않으니 받는 쪽에서 변환해 주셔야 합니다. 또 칸 개수가 첫 줄의 열 이름과 맞지 않는 줄이 있으면 변환이 멈추고 형식을 확인하라는 안내가 나옵니다.
JSON Lines(.jsonl·NDJSON)도 되나요?
됩니다. JSON → CSV에서는 입력 전체가 JSON 하나로 읽히지 않고 줄마다 { }나 [ ]로 된 JSON이 있으면 JSON Lines로 읽습니다(빈 줄은 건너뜀). CSV → JSON에서는 'JSON 모양'을 JSON Lines로 바꾸면 한 행이 한 줄의 JSON 객체로 나옵니다.
JSON ↔ CSV, 어떤 도구인가요?
JSON 배열·JSON Lines(.jsonl)와 CSV를 서로 바꿉니다. API에서 받은 목록 데이터를 엑셀이나 스프레드시트에서 훑어보고 싶을 때, 반대로 표로 정리해 둔 데이터를 코드에 넣을 JSON으로 만들 때 씁니다. 줄마다 JSON 객체가 하나씩 든 JSON Lines는 따로 고르지 않아도 알아서 읽고, 값 안에 쉼표나 따옴표, 줄바꿈이 들어 있어도 CSV 규칙에 맞게 감싸 주기 때문에 열이 밀리지 않습니다.
이럴 때 쓰세요
API 응답을 엑셀에서 볼 때
JSON 배열을 붙여 넣으면 CSV가 바로 나오고, 아래 저장 버튼으로 받으면 엑셀에서 한글이 깨지지 않게 열립니다.
로그·내보내기 파일(.jsonl)을 표로 볼 때
줄마다 JSON이 하나씩 든 로그나 데이터 내보내기 파일을 그대로 붙여 넣으면 JSON Lines로 알아보고 몇 줄을 읽었는지 알려 준 뒤 CSV로 바꿉니다.
표 데이터를 코드·데이터 파이프라인에 넣을 때
CSV를 JSON 배열로 바꾸거나, 한 줄에 한 행씩 처리하는 도구에 넣을 JSON Lines로 바꿀 수 있습니다.
사용 방법
변환 방향 고르기
JSON → CSV와 CSV → JSON 탭 중 하나를 선택합니다. 입력을 넣은 뒤 탭을 바꾸면 같은 내용으로 반대 변환이 실행됩니다.
- CSV → JSON에서는 오른쪽 위 'JSON 모양'에서 JSON 배열과 JSON Lines(줄마다 객체 하나) 중 고릅니다.
데이터 붙여넣기
왼쪽 입력창에 JSON 배열·JSON Lines나 CSV 표를 붙여넣습니다. CSV는 맨 첫 줄을 열 이름으로 읽습니다.
- JSON Lines로 읽으면 입력창 아래에 '줄마다 JSON 하나로 읽었어요'와 줄 수가 나옵니다. 틀린 줄이 있으면 몇 번째 줄인지 알려 줍니다.
결과 복사·저장하기
오른쪽 패널의 복사 버튼으로 결과를 가져가거나, 아래 저장 버튼으로 변환결과.csv·.json·.jsonl 파일을 받습니다.
- CSV 파일은 엑셀에서 한글이 깨지지 않도록 UTF-8 BOM을 붙여 저장합니다. xlsx 파일이 필요하면 'Excel ↔ CSV'에 올리거나, JSON을 바로 엑셀로 만드는 '엑셀 JSON 변환'을 쓰면 됩니다.
자주 나는 문제와 해결
- '올바른 JSON이 아닙니다'라고 나와요
- 끝에 남은 쉼표, 작은따옴표로 감싼 문자열, 따옴표 없는 키처럼 JavaScript에서는 되지만 JSON에서는 안 되는 표기가 흔한 원인입니다. 'JSON Pretty'에 붙여 넣으면 어느 위치가 틀렸는지 보기 쉽습니다.
- 'JSON Lines 몇 번째 줄이 올바른 JSON이 아닙니다'라고 나와요
- 알려 준 줄만 고치면 됩니다. 한 줄에 JSON 객체 하나가 통째로 들어 있어야 하므로, 보기 좋게 여러 줄로 펼쳐 둔 JSON은 JSON Lines가 아니라 대괄호 [ ]로 감싼 배열로 넣어 주세요.
- 'CSV를 변환하지 못했습니다'라고 나와요
- 칸 개수가 첫 줄의 열 이름 수와 다른 줄이 있거나, 따옴표로 시작한 칸이 닫히지 않은 경우입니다. 엑셀에서 '다른 이름으로 저장 → CSV UTF-8'로 다시 저장한 파일 내용을 붙여 넣으면 대부분 해결됩니다.