CSV 를 JSON 으로 변환하기

TL;DR

CSV/JSON Converter 는 브라우저 안에서만 완전히 동작합니다. 데이터는 로컬에서 파싱되고 변환됩니다 — 업로드도, 서버 측 처리도 없습니다. CSV to JSON 과 JSON to CSV 방향 사이를 전환하고, 구분자를 선택하고, 헤더 처리를 설정한 뒤, 결과를 복사하거나 다운로드하기 전에 행과 열 요약을 읽을 수 있습니다.

이 도구는 양방향 변환을 모두 처리하고, 요청하면 구분자를 자동 감지하며, (고르지 못한 행 같은) 문제를 데이터를 조용히 버리는 대신 경고로 보고합니다.

브라우저에서 변환하는 이유

CSV 는 데이터 내보내기의 공용어입니다 — 스프레드시트, 데이터베이스, API 모두 CSV 를 내놓습니다 — 하지만 애플리케이션 코드가 원하는 것은 거의 항상 JSON 입니다. 브라우저에서 변환한다는 것은 민감한 행(고객 목록, 재무 내보내기, 로그)이 제3자 서버에 닿지 않음을 의미합니다. 또한 즉각적인 피드백도 의미합니다. 구분자를 바꾸거나 헤더를 켜면 출력이 즉시 업데이트되며, 확정하기 전에 살펴볼 수 있는 미리보기가 표시됩니다.

CSV 를 JSON 으로 변환하기

1. CSV/JSON Converter 를 열고 CSV to JSON 모드를 선택합니다.
2. 소스 영역에 CSV 를 붙여넣습니다.
3. Delimiter 를 선택합니다: Auto (기본값, 구분 기호를 감지), Comma, Semicolon, Tab, Pipe. 내보내기가 쉼표로 구분되는지 세미콜론으로 구분되는지 확실하지 않을 때 Auto 가 유용합니다.
4. 출력을 형성하는 CSV 옵션을 설정합니다:
   • Header — 첫 번째 행을 필드 이름으로 취급하여 JSON 이 배열 인덱스 대신 객체 키를 사용하도록 합니다.
   • Dynamic typing — 숫자 및 불리언처럼 보이는 값을 문자열로 남기는 대신 실제 숫자와 불리언으로 변환합니다.
   • Skip empty lines — 빈 레코드를 내보내는 대신 빈 줄을 무시합니다.
   • Trim headers — 더 깔끔한 객체 키를 위해 헤더 이름의 공백을 제거합니다.
   • JSON Lines — 단일 JSON 배열 대신 줄마다 하나의 JSON 객체를 내보냅니다 (NDJSON).
   • Minify — 들여쓰기를 없애 컴팩트한 출력을 생성합니다.
5. 변환을 클릭하고 summary (행, 열, 감지된 구분자, 출력 크기)와 preview 를 읽습니다.

헤더 옵션이 켜져 있으면 각 행이 헤더 이름으로 키가 지정된 객체가 됩니다. 꺼져 있으면 각 행이 값의 배열이 됩니다. 고르지 못한 행 및 기타 구조적 문제는 변환 전체를 실패시키는 대신 문제 목록에 경고로 나타납니다.

JSON 을 CSV 로 변환하기

1. JSON to CSV 모드로 전환합니다.
2. JSON 을 붙여넣습니다. 소스는 플랫한 객체의 배열(또는 변환기가 평탄화할 수 있는 값)이어야 합니다 — 깊이 중첩되거나 비표 형태의 모양은 조용히 강제되는 대신 지원되지 않음으로 보고됩니다.
3. Delimiter 를 선택합니다: Comma, Semicolon, Tab, Pipe. 자동 감지는 CSV 입력 기능이므로 CSV 를 생성할 때는 제공되지 않습니다.
4. JSON 옵션을 설정합니다:
   • Header — 객체 키에서 첫 번째 줄로 헤더 행을 작성합니다.
   • Minify — 여분의 간격 없이 컴팩트한 CSV 를 생성합니다.
5. 변환하고 요약과 미리보기를 검토합니다.

변환기는 헤더를 위해 모든 객체에 걸쳐 키의 합집합을 모으고 객체마다 한 행을 작성합니다. 유효하지 않은 JSON 은 절반만 작성된 파일을 만드는 대신 잡혀서 명확한 메시지와 함께 보고됩니다.

파일 다루기

데이터를 직접 붙여넣거나 파일을 불러올 수 있습니다. 도구는 읽기 전에 파일의 유효성을 검사합니다. 지원되지 않는 파일 종류와 너무 큰 파일은 부분 파싱 후가 아니라 (unsupportedFile 또는 fileTooLarge 로) 명시적인 메시지와 함께 즉시 거부됩니다. 완료되면, 다운로드 동작이 현재 방향에 대해 igottools-csv-json-converter.json (또는 .csv)라는 파일을 생성합니다.

요약과 미리보기 읽기

성공적인 모든 변환은 출력과 함께 summary 와 preview 를 반환합니다:

• Summary — 전체 행, 전체 열, 실제로 사용된 구분자, 오류 수, 출력 크기 (바이트).
• Preview — 감지된 헤더와 변환된 행의 표본으로, 복사하거나 다운로드하기 전에 구조를 확인할 수 있습니다.
• Issues — 변환이 주의사항과 함께 성공할 때 (예: 고르지 못한 행이나 강제된 값) 행 번호가 매겨진 경고 목록으로 나타납니다. 순수한 성공에는 문제가 없습니다. 치명적인 실패는 message 키를 포함한 무효 결과를 반환합니다.

정직한 한계와 주의사항

• 플랫한 데이터가 가장 좋습니다. 변환기는 표 형식 데이터, 즉 플랫한 레코드의 배열을 위해 만들어졌습니다. 깊이 중첩된 JSON 이나 균일하지 않은 객체는 휴리스틱하게 평탄화되는 대신 지원되지 않는 형태로 보고될 수 있습니다.
• 자동 감지는 CSV 입력 전용입니다. CSV 를 생성할 때는 구체적인 구분자를 선택해야 합니다. 그 방향에서는 Auto 를 사용할 수 없습니다.
• 파일 크기에 한계가 있습니다. 너무 큰 파일은 파싱 전에 거부됩니다. 매우 큰 데이터셋의 경우 입력을 분할하거나 전용 오프라인 파이프라인을 사용하세요.
• 동적 타이핑은 옵트인입니다. 기본적으로 값은 문자열로 남아 소스에 있던 것을 정확히 볼 수 있습니다. 데이터가 일관되게 숫자이거나 불리언이라고 신뢰할 때만 동적 타이핑을 켜세요.
• 저장 없음. 변환기는 입력이나 출력을 기억하지 않습니다. 페이지를 새로고침하면 모두 지워집니다 — 민감한 데이터에 대한 안전한 기본값입니다.

관련 도구

• JSON Formatter — 방금 생성한 JSON 을 보기 좋게 출력, 검증, 탐색합니다. /ko/tools/dev/json-formatter/ 를 참조하세요.
• JSONPath Tester — 변환된 JSON 을 JSONPath 식으로 쿼리하여 필요한 행을 꺼냅니다. /ko/tools/dev/jsonpath-tester/ 를 참조하세요.
• JSON to TypeScript — 변환된 JSON 에서 애플리케이션 코드용 TypeScript 타입을 생성합니다. /ko/tools/dev/json-to-typescript/ 를 참조하세요.

FAQ

데이터가 어디에 업로드되나요?

아닙니다. 변환은 브라우저 안에서만 완전히 실행됩니다. CSV, JSON 및 불러온 파일은 모두 로컬에서 파싱 및 변환되며 서버로 전송되지 않습니다.

어떤 구분자를 사용할 수 있나요?

CSV 입력의 경우: Auto, Comma, Semicolon, Tab, Pipe. JSON-에서-CSV 출력의 경우: Comma, Semicolon, Tab, Pipe (CSV 를 생성할 때는 자동 감지가 제공되지 않습니다).

Header 옵션은 무엇을 하나요?

CSV to JSON 에서는 첫 번째 행을 필드 이름으로 취급해 각 레코드가 배열 대신 그 이름으로 키가 지정된 객체가 됩니다. JSON to CSV 에서는 객체 키를 출력의 첫 번째 행으로 작성합니다.

고르지 못하거나 잘못된 입력에서는 어떻게 되나요?

치명적인 실패 (빈 입력, 유효하지 않은 JSON, 지원되지 않는 형태)는 명확한 무효 결과를 반환합니다. 고르지 못한 행 같은 복구 가능한 문제는 행 번호가 매겨진 경고 목록과 함께 성공적인 변환을 생성하므로, 나머지 데이터를 잃지 않고 무엇이 조정되었는지 볼 수 있습니다.

JSON Lines (NDJSON) 출력을 얻을 수 있나요?

네. CSV to JSON 모드에서 JSON Lines 를 켜면 단일 JSON 배열 대신 줄마다 하나의 JSON 객체를 내보냅니다 — 스트리밍 파서와 로그 스타일 파이프라인에 편리합니다.