자주 묻는 질문
JSON to CSV 변환 도구에 대한 자주 묻는 질문과 답변입니다.
일반 질문
JSON to CSV 변환기란 무엇인가요?
JSON to CSV 변환기는 JSON(JavaScript Object Notation) 데이터를 CSV(Comma-Separated Values) 형식으로 변환하는 웹 기반 도구입니다. 데이터 분석, 리포팅, 스프레드시트 앱과의 연동에 유용합니다.
내 데이터는 안전한가요?
네. 모든 처리는 브라우저에서 로컬로 수행되며 외부 서버로 전송되지 않습니다. 데이터는 기기를 벗어나지 않습니다.
설치가 필요한가요?
설치할 필요가 없습니다. 도구는 웹 브라우저에서만 동작하며, 인터넷에 접속할 수 있는 최신 기기에서 사용할 수 있습니다.
무료인가요?
네. JSON to CSV 변환기는 완전히 무료이며 제한이 없습니다.
기술 질문
어떤 브라우저를 지원하나요?
다음과 같은 최신 브라우저에서 동작합니다:
- Chrome 60+
- Firefox 55+
- Safari 12+
- Edge 79+
처리 가능한 최대 파일 크기는 얼마인가요?
고정된 한도는 없지만 성능은 기기의 메모리에 따라 달라집니다. 일반적으로:
- 작은 파일(< 1MB): 즉시 처리
- 중간 파일(1-10MB): 빠른 처리
- 큰 파일(> 10MB): 몇 초가 걸릴 수 있음
중첩 JSON 객체도 처리할 수 있나요?
네. 도구가 점 표기법(dot notation)으로 중첩 객체를 자동으로 평탄화합니다. 예:
{ "user": { "name": "John", "age": 30 } }
다음과 같이 변환됩니다:
user.name,user.age
John,30
배열은 어떻게 처리되나요?
객체 내부의 배열은 구조를 유지하기 위해 JSON 문자열로 변환됩니다:
{ "tags": ["red", "blue", "green"] }
다음과 같이 변환됩니다:
tags
"[""red"",""blue"",""green""]"
데이터 형식 질문
어떤 JSON 형식을 지원하나요?
다음을 지원합니다:
- 객체 배열:
[{"name": "John"}, {"name": "Jane"}] - 단일 객체:
{"name": "John", "age": 30} - 중첩 객체: 자동 평탄화
- 혼합 데이터 타입: 숫자, 문자열, 불리언, null
어떤 CSV 형식을 생성할 수 있나요?
다음을 생성할 수 있습니다:
- 표준 CSV(쉼표 구분)
- 유럽식 CSV(세미콜론 구분)
- TSV(탭 구분)
- 파이프(|) 구분
- 사용자 지정 구분자 형식
특수 문자는 어떻게 처리되나요?
특수 문자는 올바르게 이스케이프됩니다:
- 따옴표:
"Hello"→""Hello"" - 쉼표:
Smith, John→"Smith, John" - 줄바꿈: 올바르게 이스케이프하여 유지
국제 문자는요?
UTF-8 인코딩으로 모든 Unicode 문자를 지원합니다:
- Chinese: 中文
- Japanese: 日本語
- Arabic: العربية
- Emojis: 🚀 📊 ✅
사용 질문
컬럼 헤더를 포함하려면 어떻게 하나요?
변환 설정에서 "Include Headers" 옵션을 켜면 됩니다. 첫 번째 행에 컬럼 이름이 추가됩니다.
구분자를 커스터마이즈할 수 있나요?
네. 다음 중에서 선택할 수 있습니다:
- Comma (,) - Standard CSV
- Semicolon (;) - European format
- Tab - TSV format
- Pipe (|) - Custom format
빈 값은 어떻게 처리되나요?
빈 값이나 null은 CSV 출력에서 빈 문자열로 변환됩니다. 변환 옵션에서 동작을 조정할 수도 있습니다.
변환 기록을 저장할 수 있나요?
네. 도구가 브라우저 로컬에 최근 50개의 변환 기록을 자동 저장합니다. 이전 변환을 불러오거나 기록을 삭제할 수 있습니다.
오류 처리
JSON이 유효하지 않으면 어떻게 되나요?
도구가 오류를 강조 표시하고 "Invalid JSON format. Please check your input." 같은 메시지를 보여줍니다. 흔한 원인:
- 객체 사이 쉼표 누락
- 대괄호/중괄호 불일치
- 따옴표 미이스케이프
- 끝에 남은 쉼표
CSV가 비어 있는 이유는 무엇인가요?
보통 다음 경우입니다:
- JSON 입력이 비어 있음
- JSON이 빈 배열/빈 객체만 포함
- 검증 오류로 변환이 진행되지 않음
변환 오류를 어떻게 해결하나요?
- 온라인 JSON 검증기로 JSON을 검사
- 흔한 문법 오류 확인
- 객체 구조가 일관적인지 확인
- 끝에 남은 쉼표 제거
성능 질문
변환 속도는 얼마나 빠른가요?
데이터 크기에 따라 달라집니다:
- 작은 데이터(< 100 레코드): 즉시
- 중간(100-1000 레코드): 1초 미만
- 큰 데이터(> 1000 레코드): 1-5초
매우 큰 파일도 처리할 수 있나요?
가능하지만 다음을 고려하세요:
- 브라우저 메모리 제한
- 크기가 커질수록 처리 시간이 증가
- 매우 큰 파일은 분할을 권장
오프라인으로도 동작하나요?
네. 페이지가 한 번 로드되면 완전히 오프라인으로 동작하며 변환에 인터넷 연결이 필요하지 않습니다.
통합 질문
내 애플리케이션에서 사용할 수 있나요?
이 도구는 웹 사용을 위해 설계되었지만 다음이 가능합니다:
- 브라우저 버전으로 수동 변환
- 애플리케이션에 유사한 로직 구현
- 제공된 코드 예시를 참고해 통합
Excel로 CSV를 가져오려면?
- JSON을 CSV로 변환
- CSV 데이터를 복사
- Excel 열기
- 붙여넣기
- 필요하면 "Text to Columns" 사용
Google Sheets에서도 사용할 수 있나요?
네. 생성된 CSV는 Google Sheets와 호환됩니다:
- JSON을 CSV로 변환
- CSV 파일 다운로드
- Google Sheets로 가져오기
- 또는 복사/붙여넣기
문제 해결
브라우저에서 도구가 동작하지 않아요
다음을 시도해 보세요:
- 브라우저를 최신 버전으로 업데이트
- 캐시와 쿠키 삭제
- 브라우저 확장 기능을 잠시 비활성화
- 다른 브라우저로 시도
인코딩 문제가 발생해요
국제 문자의 경우:
- UTF-8 인코딩 사용
- JSON이 올바르게 인코딩되었는지 확인
- 대상 애플리케이션이 UTF-8을 지원하는지 확인
Excel에서 CSV가 이상하게 보여요
가능한 원인:
- 구분자 설정(유럽권 Excel은 세미콜론이 필요할 수 있음)
- 인코딩 문제(UTF-8로 저장)
- 따옴표 이스케이프 문제
데이터가 잘려요
다음을 확인하세요:
- 매우 긴 텍스트 필드
- 문제를 일으키는 특수 문자
- 브라우저 메모리 제한
- Excel 셀 문자 제한(32,767자)
고급 질문
CSV를 다시 JSON으로 변환할 수 있나요?
이 도구는 JSON → CSV만 지원합니다. 역변환에는 별도의 CSV to JSON 도구가 필요합니다.
복잡한 중첩 구조는 어떻게 처리하나요?
도구가 자동으로 평탄화합니다. 매우 복잡한 구조라면:
- JSON을 사전 처리
- 더 전문적인 도구 사용
- 데이터를 수동으로 재구성
출력 형식을 커스터마이즈할 수 있나요?
현재 제공되는 옵션:
- 구분자 선택
- 인코딩 선택
- 헤더 포함 여부
- 따옴표 이스케이프
API 버전이 있나요?
현재는 웹 기반 도구만 제공합니다. 프로그램에서 사용하려면 제공된 코드 예시를 참고해 변환 로직을 구현하세요.
지원 질문
어디에서 도움을 받을 수 있나요?
- 문서 섹션 확인
- 예제 확인
- 샘플 데이터로 테스트
- 문제가 지속되면 지원 문의
새 기능을 제안할 수 있나요?
네. 다음 정보를 함께 제공해 주세요:
- 필요한 기능의 구체적인 내용
- 사용 사례
- 워크플로에 어떤 도움이 되는지
모바일 버전이 있나요?
모바일 브라우저에서도 동작하지만 더 나은 경험을 위해:
- 큰 데이터는 가로 모드를 권장
- 복잡한 데이터는 태블릿 권장
- 최초 로딩 시 안정적인 네트워크 권장