JSON을 CSV로 변환기

객체 배열

객체 배열은 각 객체가 하나의 행이 되므로 CSV에 가장 명확한 소스입니다.

[
  {"id": 1, "name": "Ada"},
  {"id": 2, "name": "Lin"}
]

키는 열이 되고 객체는 행이 됩니다.

단일 객체

단일 평면 객체는 하나의 CSV 행이 됩니다. 객체에 레코드의 중첩 배열이 포함된 경우 도구에서 해당 배열을 레코드 소스로 선택할 수 있습니다.

{
  "results": [
    {"id": 1, "status": "active"},
    {"id": 2, "status": "paused"}
  ],
  "count": 2
}

results를 선택하면 두 개의 행이 생성됩니다. 래퍼 값 count는 세 번째 레코드로 변환되지 않습니다.

키가 다른 객체

실제 JSON 배열에는 항상 동일한 객체가 포함되지는 않습니다. 변환기는 선택한 레코드에서 키의 합집합을 만듭니다.

[
  {"id": 1, "email": "[email protected]"},
  {"id": 2, "phone": "555-0100"}
]

CSV에는 id, email, phone 열이 포함되며, 레코드에 해당 키가 없는 경우 빈 값이 표시됩니다.

중첩된 객체는 일반 CSV 열에 직접 맞출 수 없습니다. 이 도구는 기본 객체 경로를 열 이름으로 평탄화합니다.

{
  "user": {
    "name": "Ada",
    "address": {
      "city": "London"
    }
  }
}

제안된 열:

user.name
user.address.city

옵션 패널에는 중첩 객체 평탄화 켜기/끄기, 경로 구분 기호, 최대 평탄화 깊이 및 최대 깊이 도달 후 동작이 포함됩니다.

배열은 하나의 CSV 셀이 반복되는 구조화된 레코드를 자연스럽게 표현할 수 없기 때문에 신중한 출력 규칙이 필요합니다.

• 기본 값 결합: ["red","blue"]는 red, blue가 됩니다.
• JSON으로 유지: 전체 배열 텍스트를 하나의 인용된 셀에 보존합니다.
• 비워 둠: 명시적 사용자 선택으로만 사용할 수 있으며, 절대 기본값이 아닙니다.

구분 기호

쉼표, 세미콜론, 탭, 파이프 또는 지원되는 사용자 지정 단일 문자를 선택하세요. 선택한 구분 기호는 헤더와 모든 행에 일관되게 적용됩니다.

헤더 행

기본 출력에는 열 이름이 포함됩니다. 토글을 사용하면 원시 행만 허용하는 시스템의 경우 헤더를 제거할 수 있습니다.

인용

구분 기호, 따옴표 또는 줄 바꿈을 포함하는 CSV 값은 올바르게 인용됩니다. 인용된 필드 내의 리터럴 따옴표는 이스케이프됩니다.

• 최소 인용
• 모든 필드 인용
• 줄 끝
• 스프레드시트 호환을 위해 필요한 경우 UTF-8 BOM 포함

빈 값 및 null 값

null, 누락된 키 및 빈 문자열을 어떻게 표현할지 선택하세요: 빈 셀, 리터럴 null 또는 사용자 지정 자리 표시자. 미리 보기에서 다운로드 전에 차이를 확인할 수 있습니다.

미리 보기에는 감지된 레코드 수, 생성된 열 수, 선택한 레코드 경로 및 일관되지 않은 객체 모양이나 중첩 배열에 대한 경고와 함께 처음 렌더링된 행의 테이블 보기가 표시됩니다. 원시 CSV 출력은 인용을 검사해야 할 때 사용할 수 있습니다.

출력에 행이 하나만 있습니다

선택한 JSON 값이 레코드 배열이 아니라 단일 객체일 가능성이 높습니다. 레코드가 포함된 중첩 배열을 선택하세요.

중첩 필드가 누락되었습니다

평탄화를 활성화하거나 "중첩 값을 JSON으로 유지"를 선택하세요. 도구는 값이 구성된 평탄화 깊이를 초과할 때 경고합니다.

일부 행에 빈 셀이 있습니다

JSON 객체에 다른 키가 있거나 값이 누락되었습니다. CSV에는 하나의 공유 열 집합이 필요하므로 누락된 값은 빈 셀이나 선택한 자리 표시자가 됩니다.

배열이 Excel에서 읽을 수 없습니다

배열 전략을 변경하세요. 간단한 태그의 경우 기본 값을 결합하거나 구조가 중요한 경우 원래 배열을 압축된 JSON으로 유지하세요.

악센트 문자가 올바르게 표시되지 않습니다

UTF-8 호환 설정으로 다운로드하고 올바른 인코딩을 사용하여 파일을 여세요. BOM 옵션이 있는 경우 바이트 접두사만 변경하며 콘텐츠를 다시 인코딩하지 않습니다.