쉼표 · 따옴표가 값에 들어 있으면?

RFC 4180 표준대로 처리합니다. 값 안에 쉼표가 있으면 따옴표로 감싸고, 값 안의 따옴표는 `""` 로 이스케이프.

헤더가 없는 CSV 도 변환되나요?

옵션으로 `header: false` 설정하면 각 행이 `["a", "b", ...]` 배열로 변환됩니다.

기본은 모든 값을 문자열로 둡니다 (가장 안전). 숫자·boolean 자동 변환 옵션을 켜면 `"true"` → `true`, `"42"` → `42` 변환.

예시

name,email,active
yutils,hello@yutils.dev,true
jade,jade@example.com,false

[
  { "name": "yutils", "email": "hello@yutils.dev", "active": "true" },
  { "name": "jade", "email": "jade@example.com", "active": "false" }
]

첫 줄 헤더 자동 인식. 쉼표가 포함된 값은 따옴표로 감싸기. 양방향 변환 — JSON 배열 → CSV 도 지원.

사용법 / 자주 묻는 질문

Q.쉼표 · 따옴표가 값에 들어 있으면?: A.RFC 4180 표준대로 처리합니다. 값 안에 쉼표가 있으면 따옴표로 감싸고, 값 안의 따옴표는 `""` 로 이스케이프.
Q.헤더가 없는 CSV 도 변환되나요?: A.옵션으로 `header: false` 설정하면 각 행이 `["a", "b", ...]` 배열로 변환됩니다.
Q.타입 추론이 자동인가요?: A.기본은 모든 값을 문자열로 둡니다 (가장 안전). 숫자·boolean 자동 변환 옵션을 켜면 `"true"` → `true`, `"42"` → `42` 변환.

재미있는 사실

CSV 는 1972년 IBM Fortran 의 list-directed I/O 가 원조이지만 공식 표준 없이 30년 넘게 사실상 표준으로 굳어졌습니다. 2005년 RFC 4180 이 첫 informal spec — 그 전엔 모든 도구가 살짝씩 다른 dialect 였어요.
RFC 4180 (2005)
Excel 의 UTF-8 BOM 함정 — Excel 이 UTF-8 CSV 를 한글 깨짐 없이 읽으려면 파일 첫 3바이트에 BOM (`EF BB BF`) 가 필요합니다. BOM 없으면 ANSI 인코딩으로 가정 → 한글 모지바케. 이 때문에 한국 개발자들이 CSV export 할 때 항상 BOM 추가하는 패턴.
Wikipedia — BOM
유럽 일부 국가 (독일·프랑스·이탈리아 등) 는 십진 구분자가 콤마 (`1,5`) 라서 CSV 의 separator 가 세미콜론 (`;`) 입니다. Excel 도 locale 에 따라 같은 .csv 파일을 다르게 해석 — '엑셀이 CSV 깨먹는' 호환성 사고의 단골 원인.
Wikipedia — CSV