JSON CSV 변환기란?

JSON과 CSV는 데이터를 표현하는 대표적인 형식입니다. JSON(JavaScript Object Notation)은 중첩 구조를 지원하는 유연한 형식으로 API 통신이나 설정 파일에 주로 사용되고, CSV(Comma-Separated Values)는 표 형태의 데이터를 단순한 텍스트로 표현하여 스프레드시트나 데이터 분석에 널리 쓰입니다. 이 도구는 두 형식 사이의 변환을 간편하게 처리해 줍니다. 변환 시 객체 배열의 키가 CSV 헤더가 되고, 각 객체의 값이 행으로 변환됩니다.

헤더는 첫 번째 객체에서만 가져옵니다

이 도구는 배열의 첫 객체가 가진 키로 헤더를 정하고, 나머지 행은 그 헤더에 맞춰 값을 채웁니다. 구조가 일정한 데이터라면 문제가 없지만, 객체마다 키가 다른 경우에는 주의해야 합니다.

예를 들어 첫 항목이 {"id":1,"name":"김"}이고 두 번째가 {"id":2,"name":"이","phone":"010"}이라면, phone 열은 아예 만들어지지 않고 그 값은 조용히 버려집니다. 오류도 경고도 없으므로 변환 후 열 개수를 눈으로 확인하는 습관이 필요합니다. 반대로 뒤쪽 객체에 키가 빠져 있으면 그 칸은 빈 값으로 채워집니다. 키 구성이 들쭉날쭉하다면 가장 많은 키를 가진 객체를 배열 맨 앞으로 옮긴 뒤 변환하세요.

중첩 구조는 평탄화되지 않습니다

CSV는 본질적으로 2차원 표라서 중첩을 표현할 수단이 없습니다. 값이 객체나 배열이면 문자열로 바뀌면서 [object Object]라는 쓸모없는 텍스트가 됩니다. {"user":{"name":"김"}} 같은 데이터는 그대로 넣으면 안 되고, 변환 전에 {"user_name":"김"}처럼 한 단계로 펴야 합니다.

null과 undefined는 빈 칸으로 처리됩니다. 숫자 0이나 false는 값이 있는 것으로 취급되어 0, false로 기록되므로 빈 칸과 구분됩니다.

따옴표 처리는 표준을 따릅니다

값 안에 구분자나 큰따옴표, 줄바꿈이 들어 있으면 전체를 큰따옴표로 감싸고, 안에 있던 큰따옴표는 두 개로 늘려 적습니다(RFC 4180 방식). 주소 서울, 강남구는 "서울, 강남구"가 되고, 15" 모니터는 "15"" 모니터"가 됩니다. 엑셀과 구글 스프레드시트를 포함한 대부분의 프로그램이 이 규칙을 이해하므로 그대로 열면 됩니다.

한국에서 엑셀로 열 때

구분자를 고를 수 있게 해둔 이유가 있습니다. 한국어 윈도우의 엑셀은 CSV를 열 때 시스템 목록 구분 기호를 기준으로 열을 나누는데, 이 설정이 쉼표가 아닌 경우가 있어 쉼표 CSV가 한 열에 뭉쳐 보이기도 합니다. 그럴 때는 탭이나 세미콜론으로 내보내면 대개 해결됩니다.

한글이 깨져 보이는 것은 다른 문제입니다. 결과물은 UTF-8인데 엑셀이 시스템 기본 인코딩으로 읽으려 해서 생기는 현상이라, 엑셀에서 바로 여는 대신 데이터 → 텍스트/CSV 가져오기로 불러와 원본 파일 형식을 UTF-8로 지정하면 정상적으로 표시됩니다. 구글 스프레드시트는 UTF-8을 기본으로 인식하므로 이런 과정이 필요 없습니다.

자주 묻는 질문

JSON이 배열이 아니면 왜 안 되나요?

CSV의 한 행이 객체 하나에 대응하므로 최상위가 객체 배열이어야 합니다. {"data":[...]}처럼 한 겹 싸여 있다면 안쪽 배열만 잘라서 넣으세요. 빈 배열도 헤더를 만들 근거가 없어 오류로 처리됩니다.

숫자 앞의 0이 사라집니다

변환 결과에는 그대로 남아 있고, 엑셀이 열면서 숫자로 해석해 없애는 것입니다. 사번이나 우편번호처럼 자릿수를 지켜야 하는 값은 가져오기 마법사에서 해당 열의 서식을 텍스트로 지정하면 유지됩니다.

열 순서를 바꿀 수 있나요?

헤더 순서는 첫 객체의 키 순서를 그대로 따릅니다. 원하는 순서가 있다면 JSON에서 키 순서를 미리 정렬한 뒤 변환하거나, 변환 후 스프레드시트에서 열을 옮기세요.

데이터가 서버로 올라가나요?

올라가지 않습니다. 변환은 브라우저 안에서만 수행되며 어떤 요청도 발생하지 않습니다. 고객 명단처럼 개인정보가 포함된 데이터도 외부로 나가지 않지만, 결과를 내려받은 파일 자체는 평문이므로 보관과 공유에는 주의하세요.

JSON CSV 변환기