개요

text/csv는 Comma-Separated Values, 즉 쉼표로 구분한 행/열 형태의 표 데이터를 위한 미디어 타입입니다(RFC 4180). 스프레드시트 내보내기·데이터 교환에 널리 쓰이며 거의 모든 도구가 읽습니다.

자세히

RFC 4180이 기본 규칙을 정합니다: 필드는 쉼표로, 레코드는 CRLF로 구분하고, 값에 쉼표·따옴표·개행이 있으면 큰따옴표로 감싸며 값 안의 따옴표는 두 번(`""`)으로 이스케이프합니다. 선택적 헤더 행을 첫 줄에 둘 수 있습니다. 브라우저는 보통 다운로드 처리하며, `Content-Disposition: attachment; filename="data.csv"`로 파일명을 지정합니다.

실무의 최대 함정은 인코딩과 Excel입니다. UTF-8 CSV라도 마이크로소프트 Excel은 BOM(byte order mark)이 없으면 시스템 로캘로 열어 한글이 깨집니다. 그래서 Excel 호환이 필요하면 UTF-8 BOM을 파일 앞에 붙이거나, 지역에 따라 세미콜론 구분자를 쓰기도 합니다. 또한 지역 설정에 따라 소수점·구분자가 달라 데이터가 어긋날 수 있습니다.

문법

e.g. Content-Type: text/csv; charset=utf-8

파일 확장자

실무 참고

• CSV 인젝션(수식 인젝션): 값이 `=`, `+`, `-`, `@`로 시작하면 Excel이 수식으로 실행해 악성 명령이 돌 수 있습니다. 위험 문자로 시작하는 셀은 앞에 작은따옴표를 붙여 무력화하세요.
• 한글 깨짐 방지를 위해 Excel 대상 CSV에는 UTF-8 BOM을 붙이는 것이 실무 관행입니다.
• RFC의 CRLF·따옴표 이스케이프 규칙을 지키지 않으면 값에 쉼표·개행이 섞였을 때 열이 밀립니다.

관련 타입

관련 헤더