기본 사용법

이 가이드는 JSON 데이터를 CSV 형식으로 변환할 때 필요한 기본 단계를 설명합니다.

1단계: JSON 데이터 입력

지원되는 입력 형식

객체 배열(가장 일반적):

[
  { "name": "John Doe", "age": 30, "city": "New York" },
  { "name": "Jane Smith", "age": 25, "city": "Los Angeles" },
  { "name": "Bob Johnson", "age": 35, "city": "Chicago" }
]

단일 객체:

{
  "name": "John Doe",
  "age": 30,
  "city": "New York",
  "email": "john@example.com"
}

중첩 객체(자동 평탄화):

[
  {
    "user": {
      "name": "John",
      "contact": {
        "email": "john@example.com",
        "phone": "123-456-7890"
      }
    },
    "status": "active"
  }
]

2단계: 변환 옵션 설정

구분자 선택

CSV에서 값을 구분하는 문자를 선택합니다.

• 쉼표 (,): 표준 CSV 형식
• 세미콜론 (;): 유럽권 CSV 형식
• 탭: 탭으로 구분된 값(TSV)
• 파이프 (|): 파이프 구분 값

인코딩 옵션

출력에 사용할 문자 인코딩을 선택합니다.

• UTF-8: 모든 언어를 지원하는 범용 인코딩
• UTF-16: 16비트 문자를 사용하는 유니코드 인코딩
• GBK: 중국어 문자 인코딩

서식 옵션

헤더 포함:

• ✅ 사용: 첫 번째 행에 열 이름 포함
• ❌ 사용 안 함: 데이터만 출력하고 열 헤더는 제외

따옴표 이스케이프:

• ✅ 사용: 데이터 안의 따옴표를 올바르게 이스케이프
• ❌ 사용 안 함: 따옴표를 처리하지 않고 원본 그대로 출력

3단계: 출력 결과 확인

변환된 CSV는 출력 영역에 표시되며 다음 정보를 함께 확인할 수 있습니다.

• 실시간 미리보기: 입력하면서 결과 확인
• 통계 정보: 행 수, 열 수, 파일 크기
• 오류 처리: 잘못된 JSON에 대한 명확한 오류 메시지

4단계: 결과 내보내기

클립보드에 복사

"Copy CSV" 버튼을 클릭하면 결과를 클립보드에 복사하여 다른 애플리케이션에 붙여넣을 수 있습니다.

파일 다운로드

"Download CSV" 버튼을 클릭하면 타임스탬프가 포함된 파일명으로 컴퓨터에 저장할 수 있습니다.

변환 예시

입력 JSON:

[
  { "product": "Laptop", "price": 999.99, "category": "Electronics" },
  { "product": "Mouse", "price": 29.99, "category": "Accessories" },
  { "product": "Keyboard", "price": 79.99, "category": "Accessories" }
]

출력 CSV(헤더 포함):

product,price,category
Laptop,999.99,Electronics
Mouse,29.99,Accessories
Keyboard,79.99,Accessories

일반적인 문제와 해결 방법

잘못된 JSON 형식

문제: 입력 영역에 빨간 테두리가 표시됨 해결 방법: 쉼표, 괄호, 따옴표가 빠지지 않았는지 확인

출력이 비어 있음

문제: CSV가 생성되지 않음 해결 방법: JSON이 유효하고 데이터가 포함되어 있는지 확인

헤더 누락

문제: 출력에 열 이름이 없음 해결 방법: "Include Headers" 옵션을 활성화

특수 문자 깨짐

문제: 데이터가 손상되었거나 깨져 보임 해결 방법: "Escape Quotes"를 활성화하고 적절한 인코딩을 선택