CSV 값 안에 쉼표가 있을 때 큰따옴표 쓰는 법
주소나 설명 안에 쉼표가 들어가면 그 값을 큰따옴표로 묶으면 됩니다. 그래야 쉼표를 새 열의 시작으로 오해하지 않습니다.
잘못 읽힐 수 있는 형태
1,김민수,서울, 강남구,01012345678
한 칸으로 유지하는 형태
1,김민수,"서울, 강남구",01012345678값 안에 큰따옴표 자체가 필요하다면 두 번 적습니다.
1,"상품명은 ""블랙""입니다"실제 값은 상품명은 "블랙"입니다가 됩니다.
메모 안에 줄바꿈이 있어도 한 칸으로 쓸 수 있습니다
1,"배송 전 연락
부재 시 경비실"큰따옴표 안에 있는 줄바꿈은 한 셀의 내용으로 읽을 수 있습니다. 그래서 CSV의 실제 데이터 건수는 화면에 보이는 줄 수와 다를 때도 있습니다.
직접 고쳤다면 앞뒤 몇 줄도 같이 열어보세요
큰따옴표 하나가 빠지면 그 행만이 아니라 다음 행까지 같이 어긋날 수 있습니다. 한 줄을 고친 뒤 바로 아래 2~3줄이 다시 정상적으로 나뉘는지도 봅니다.
CSV를 손으로 자주 고쳐야 한다면 원본을 덮어쓰지 말고 복사본에서 작업하는 편이 좋습니다. 잘못 저장했을 때 돌아갈 파일이 남아 있어야 합니다.
오류가 여러 줄 이어진다면
앞 행에서 큰따옴표가 닫히지 않았는지 보세요. 파일을 읽는 프로그램은 닫는 따옴표가 나올 때까지 다음 줄도 같은 값이라고 생각할 수 있습니다.
쉼표가 값 안에 있으면 큰따옴표로 한 셀임을 알려야 합니다
예를 들어 세 열이 name,address,memo이고 주소가 ‘대구, 달서구’라면 다음처럼 저장해야 주소가 한 칸으로 유지됩니다.
name,address,memo
홍길동,"대구, 달서구",배송 전 연락값 자체에 큰따옴표가 들어가면 CSV에서는 큰따옴표를 두 번 써서 표현합니다. 이런 규칙을 직접 손으로 맞추기 어렵다면 원본 프로그램의 CSV 내보내기 기능을 이용하는 편이 안전합니다.
한 줄을 고쳤다면 앞뒤 행도 같이 검사하세요
- 열이 처음 어긋나는 행을 찾습니다.
- 쉼표·큰따옴표·줄바꿈이 있는 값을 확인합니다.
- 큰따옴표가 열리고 닫히는 위치가 맞는지 봅니다.
- 수정 뒤 CSV 검사기로 열 개수가 다시 일정한지 확인합니다.
오류가 한 행이 아니라 이후 모든 행에 이어진다면 닫히지 않은 큰따옴표 때문에 다음 줄까지 한 값으로 읽히는 경우가 있습니다. 이때는 마지막으로 정상인 행과 처음 비정상인 행 사이를 먼저 보세요.
따옴표 오류와 같이 확인할 증상
큰따옴표 때문에 행이 어긋났는지 확인해보세요.
값 안의 쉼표·줄바꿈·따옴표를 구분하세요
필드 안에 구분 문자나 줄바꿈이 들어가면 필드 전체를 큰따옴표로 감쌉니다. 값 자체에 큰따옴표가 있다면 큰따옴표를 두 번 써야 합니다. 이 규칙이 하나라도 빠지면 한 행의 열 수가 늘거나 여러 줄이 서로 다른 행으로 읽힐 수 있습니다.
주소: 101,"서울시 중구, 1층"
문구: 102,"15"" 노트북"
메모: 103,"첫 줄
둘째 줄"직접 문자열을 이어 붙여 CSV를 만들기보다 사용하는 언어나 프로그램의 CSV 내보내기 기능을 이용하세요. 내보내기 기능은 필요한 필드에 따옴표를 붙이고 값 안의 따옴표를 이스케이프하는 규칙을 처리합니다.
완성 파일은 정상 행과 쉼표·따옴표·줄바꿈이 포함된 행을 각각 골라 다시 불러옵니다. 모든 행의 열 개수가 헤더와 같은지, 메모의 줄바꿈이 한 셀 안에 유지되는지, 따옴표가 한 개로 표시되는지 확인하세요.
오류가 난 지점보다 앞에서 따옴표를 찾으세요
CSV 파서가 특정 행에서 오류를 보고해도 실제 원인은 이전 행에서 닫히지 않은 큰따옴표일 수 있습니다. 오류 행만 반복해서 고치지 말고 바로 앞의 따옴표 포함 행부터 확인하세요. 따옴표 개수만 세기보다 필드가 시작되고 끝나는 위치를 봅니다.
데이터베이스나 스프레드시트에서 내보낸 파일이라면 직접 텍스트를 수정하기보다 원본 값의 따옴표와 줄바꿈을 정리한 뒤 다시 내보내세요. 수정 후에는 전체 행의 열 개수, 행 수와 따옴표가 포함된 대표 값을 다른 프로그램에서도 열어 검산합니다.
빈 값과 빈 문자열도 구분될 수 있습니다
a,,c처럼 구분자 사이가 비어 있는 값과 a,"",c처럼 빈 문자열을 명시한 값은 프로그램에 따라 다르게 처리될 수 있습니다. 업로드 시스템이 둘을 같은 빈 값으로 보는지 확인하세요.
필수 열에서는 빈 값을 임의로 따옴표로 채우지 말고 원본 규칙에 따라 누락을 처리합니다. 데이터베이스의 NULL과 빈 문자열을 구분해야 하는 작업이라면 변환 규칙을 문서에 남기세요.
자주 묻는 질문
값 안에 쉼표가 있을 때만 큰따옴표를 쓰나요?
쉼표뿐 아니라 셀 안 줄바꿈이나 큰따옴표가 있을 때도 값 전체를 큰따옴표로 감싸야 합니다.
값 안의 큰따옴표는 어떻게 적나요?
큰따옴표를 두 번 이어 씁니다. 예를 들어 15인치라는 값은 CSV 안에서 큰따옴표 규칙에 맞춰 두 번 표시합니다.
큰따옴표를 모든 값에 써도 되나요?
CSV에서는 모든 필드를 큰따옴표로 감싸는 방식도 가능합니다. 다만 직접 편집보다 원본 프로그램의 내보내기를 이용하는 편이 실수를 줄입니다.