JSON ↔ CSV 변환기 작동 원리
JSON에서 CSV로 바꿀 때는 객체 배열 전체의 키를 모아 첫 행의 헤더로 만들고 각 객체의 값을 같은 열 순서로 배치합니다. 쉼표, 큰따옴표 또는 줄바꿈이 들어간 셀은 RFC 4180에서 널리 사용하는 방식처럼 큰따옴표로 감싸고 내부 따옴표를 두 번 적습니다. CSV에서 JSON으로 바꿀 때는 첫 행을 키 이름으로 사용하고 각 다음 행을 객체 하나로 만듭니다. 명확한 숫자·true·false·null은 기본 자료형으로 추론하며 JSON처럼 보이는 셀은 파싱을 시도합니다.
이 페이지의 계산과 변환은 모두 현재 브라우저에서 실행됩니다. 원문과 결과를 ReadyTools 서버에 전송하거나 데이터베이스에 저장하지 않으며, 입력 내용은 localStorage에도 기록하지 않습니다. 다만 운영체제나 브라우저의 클립보드 기록, 확장 프로그램, 화면 공유 기능은 사이트 밖의 영역이므로 민감한 데이터는 테스트용으로 바꾸어 사용하는 편이 안전합니다.
JSON ↔ CSV 변환기 사용 방법
입력 형식 확인
페이지에 표시된 입력 예시와 형식을 확인하고 분석하거나 변환할 데이터를 붙여 넣습니다. 오류 안내가 나오면 강조된 항목의 문법과 범위를 먼저 확인하세요.
브라우저에서 실행
실행 버튼을 누르면 외부 API 호출 없이 현재 탭에서 처리됩니다. 모바일에서는 완료 후 결과 카드로 자동 이동하며 키보드만으로도 모든 항목을 조작할 수 있습니다.
결과 검토·복사
결과의 구조와 주의사항을 확인한 뒤 복사 버튼을 사용합니다. 실제 프로젝트에 반영하기 전에는 대상 언어, 서비스와 데이터 규칙에 맞는지 다시 테스트하세요.
구체적인 상황으로 이해하는 활용 예시
다음 세 상황은 도구의 처리 과정과 결과 해석을 설명하기 위한 가상 예시입니다. 입력 조건을 바꾸면 결과도 달라지므로 자신의 조건과 비교해 확인하세요.
1. 객체 두 개를 표로 변환
[{"name":"가","count":2},{"name":"나","count":3}]을 JSON→CSV로 처리하면 헤더는 name,count이고 데이터는 두 행입니다. 결과의 2행은 헤더를 제외한 객체 수입니다. 스프레드시트에서 열 때 첫 줄이 헤더인지 확인하고 한글이 깨지면 UTF-8 가져오기 옵션을 사용하세요.
2. 상품명에 쉼표가 있는 경우
[{"name":"빵,우유","count":2}]에서는 쉼표를 포함한 상품명 셀을 큰따옴표로 감싸 두 열 구조를 유지합니다. CSV의 쉼표를 모두 단순 분할하면 상품명이 두 셀로 잘못 나뉠 수 있습니다. 인용부호와 셀 안의 줄바꿈을 처리하는 CSV 파서로 읽어야 원래 내용을 보존할 수 있습니다.
3. 숫자처럼 보이는 식별자 읽기
CSV 첫 줄 code,count와 둘째 줄 00123,2를 넣으면 이 도구는 code를 문자열 "00123", count를 숫자 2로 추정합니다. 앞쪽 0을 가진 값과 일반 숫자를 구분하는 구현 규칙입니다. 모든 열의 자료형을 지정하는 스키마는 없으므로 날짜나 매우 큰 정수처럼 특별한 값은 변환 뒤 직접 확인하세요.
스프레드시트에서 내보낸 CSV를 API 테스트용 JSON으로 만들거나, API 응답의 객체 배열을 표 계산 프로그램에서 열기 위한 CSV로 만들 때 사용할 수 있습니다. 중첩 객체와 배열은 한 셀 안의 JSON 문자열로 유지되므로 완전한 평탄화 도구와 결과가 다릅니다. CSV에는 문자 인코딩과 구분자에 여러 관례가 있으며 이 도구는 UTF-8 텍스트와 쉼표 구분을 기준으로 합니다. Excel에서 열 때 한글이 깨지면 UTF-8 가져오기 옵션을 선택하세요.
주의사항
CSV 수식으로 해석될 수 있는 =, +, -, @ 시작 값은 스프레드시트에서 열 때 보안 위험이 될 수 있습니다. 신뢰할 수 없는 데이터를 배포하거나 공유하기 전에 셀 내용을 검토하세요. 열마다 복잡한 중첩 구조가 다르면 CSV로 표현하기 어려우며 변환 후 행과 헤더 정렬을 반드시 확인해야 합니다.