CSV와 JSON은 잘하는 일이 다릅니다

CSV는 단순한 표 형식이라 스프레드시트나 대량 가져오기에서 다루기 쉽습니다.
JSON은 API 응답, 설정 데이터, 배열, 중첩 객체처럼 구조가 있는 데이터를 표현하기 좋습니다.

CSV와 JSON 변환: API 연동과 데이터 이전에서 형식을 고르는 방법

두 형식을 오갈 수 있으면 팀 간 데이터 전달, 관리자 도구의 일괄 등록, API 테스트 데이터 준비가 쉬워집니다.

CSV를 JSON으로 변환할 때

헤더 행을 키로 사용하기

많은 CSV 파일은 첫 줄에 name,email,role 같은 헤더가 있습니다.
JSON으로 변환할 때 이 헤더를 객체의 키로 사용하면 다루기 쉽습니다.

[
  { "name": "Alice", "email": "alice@example.com", "role": "admin" }
]

구분자 확인하기

CSV라고 해도 항상 쉼표로 구분되는 것은 아닙니다.
탭이나 세미콜론을 사용하는 파일도 있습니다.
열이 제대로 나뉘지 않는다면 먼저 구분자 설정을 확인하세요.

값의 타입 주의하기

CSV에서는 값이 대부분 텍스트처럼 보입니다.
JSON으로 변환한 뒤 ID, 우편번호, 전화번호처럼 숫자처럼 보여도 문자열로 유지해야 하는 값이 있는지 확인하는 것이 안전합니다.

JSON을 CSV로 변환할 때

JSON은 비슷한 키를 가진 객체 배열일 때 CSV로 변환하기 쉽습니다.
중첩 객체나 배열이 있다면 profile.name 같은 키로 평탄화하거나, 셀 안에 문자열로 넣거나, 표에 필요 없는 필드를 제외해야 합니다.

스프레드시트나 일괄 가져오기에서는 전체 구조를 완벽히 보존하는 것보다 예측 가능한 열을 만드는 편이 더 실용적입니다.

예시: 객체 배열을 CSV로 만들기

다음과 같은 JSON이 있을 때,

[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "member" }
]

모든 객체가 같은 키를 가지고 있다면 키를 헤더 행에, 값을 각 행에 대응시키기만 해도 CSV가 됩니다.

id,name,role
1,Alice,admin
2,Bob,member

반대로 객체마다 키가 제각각이면(어떤 것에는 role이 없는 등) 열이 어긋납니다. CSV로 만들기 전에 “모든 레코드가 같은 모양인가”를 확인해 두면 사고를 막을 수 있습니다.

이스케이프와 문자 인코딩의 함정

CSV는 겉보기가 단순한 만큼 값의 내용에 따라 깨지기 쉬운 형식입니다. 실무에서 걸려 넘어지기 쉬운 것은 다음 두 가지입니다.

쉼표·줄바꿈·따옴표를 포함한 값

값 자체에 쉼표나 줄바꿈이 들어 있으면 따옴표로 감싸 이스케이프하지 않는 한 열이 어긋납니다. RFC 4180에서는 값을 "..."로 감싸고 값 안의 "는 ""로 두 번 쓰는 것이 표준입니다.

id,note
1,"Hello, world"
2,"두 줄에 걸친
메모"
3,"그는 ""알겠다""고 말했다"

변환 도구나 라이브러리가 이 이스케이프를 자동으로 해 주는지 확인하세요. 직접 문자열을 이어 붙이면 거의 확실하게 이 함정을 밟습니다.

문자 인코딩과 BOM

한글이나 일본어가 들어간 CSV를 엑셀에서 열면 글자가 깨지기도 합니다. 엑셀이 UTF-8을 다른 인코딩으로 오인하기 때문이며 UTF-8(BOM 포함) 으로 내보내면 많은 환경에서 올바르게 열립니다. 반대로 프로그램에서 읽는 쪽은 BOM을 제거하지 않으면 첫 번째 키가 어긋날 수 있으므로 용도에 따라 구분해서 씁니다.

DevToolKits에서 변환하기

CSV ⇔ JSON 변환 도구는 CSV에서 JSON, JSON에서 CSV 양방향 변환을 지원합니다.
구분자와 헤더 행 설정을 바꿀 수 있어 스프레드시트와 API 응답 사이를 오가기 쉽습니다.

변환한 JSON은 JSON 포매터로 확인하고, 설정 파일로 쓰고 싶다면 JSON ⇔ YAML 변환 도구로 이어갈 수 있습니다.

자주 묻는 질문

CSV의 숫자가 JSON에서 멋대로 숫자가 됩니다

우편번호나 ID, 전화번호처럼 “숫자처럼 보여도 문자열로 다뤄야 하는 값”은 숫자화되면 앞자리 0이 사라지거나 자릿수가 넘칠 수 있습니다. 변환 시 문자열로 다루는 설정이 있으면 그것을 쓰고, 없으면 변환 후 해당 필드의 타입을 확인·수정하세요.

중첩된 JSON을 CSV로 변환할 수 있나요?

CSV는 평평한 표 형식이라 중첩된 객체나 배열은 그대로는 한 셀에 담기지 않습니다. profile.name처럼 키를 평탄화하거나, 필요한 항목만 추려서 CSV화하면 다루기 쉽습니다.

쉼표 구분인데 열이 어긋납니다

값 안에 쉼표나 줄바꿈이 포함되면, 감싸는 따옴표("...")로 올바르게 이스케이프되지 않는 한 열이 어긋납니다. 또한 CSV라고 불려도 탭이나 세미콜론 구분인 경우가 있습니다. 구분자와 따옴표 설정을 확인하세요.

엑셀에서 열면 한글이 깨집니다.

엑셀은 UTF-8 CSV를 다른 인코딩으로 오인해 글자가 깨질 수 있습니다. UTF-8(BOM 포함) 으로 다시 저장하면 많은 환경에서 올바르게 표시됩니다. 반대로 프로그램에서 읽을 때는 BOM이 불필요한 문자로 섞여 들어갈 수 있으므로 읽는 쪽에서 BOM을 제거하세요.

키가 제각각인 JSON을 CSV로 만들 수 있나요?

레코드마다 키가 다르다면 모든 키의 합집합을 헤더로 하고 없는 값은 빈칸으로 두어 하나의 CSV로 합칠 수 있습니다. 다만 열이 늘어 보기 어려워지므로 미리 데이터의 모양을 맞추거나 필요한 항목만으로 줄이는 것을 추천합니다.