CSV가 깨질 때 확인할 것: 구분자·인코딩·헤더 문제 해결 순서

한 칸에 전부 들어가면 구분자부터 확인하세요

CSV라는 이름 때문에 항상 쉼표로 나뉜다고 생각하기 쉽지만 실제 파일은 세미콜론, 탭, 파이프 같은 다른 구분자를 사용할 수 있습니다. 특히 지역 설정이나 업무 시스템에 따라 쉼표 대신 세미콜론을 쓰는 경우가 있습니다.

첫 두세 줄을 텍스트로 열어 값 사이에 반복되는 문자가 무엇인지 확인하면 구분자를 빠르게 추정할 수 있습니다. 단, 따옴표 안에 들어간 쉼표는 실제 열 구분자가 아닐 수 있습니다.

한글이 깨지면 인코딩 문제일 가능성이 큽니다

UTF-8 파일을 다른 문자셋으로 읽거나, 반대로 오래된 인코딩 파일을 UTF-8로 가정하면 한글이 깨질 수 있습니다. 열 구조가 정상인데 글자만 이상하다면 구분자보다 인코딩을 먼저 의심하세요.

원본을 다른 형식으로 저장하기 전에 먼저 어떤 인코딩으로 읽어야 정상인지 확인해야 합니다. 잘못 읽은 상태에서 다시 저장하면 깨진 글자가 그대로 굳어질 수 있습니다.

헤더가 첫 줄이라는 보장은 없습니다

정산 파일이나 리포트에는 제목, 생성일, 설명 문구가 먼저 나오고 실제 열 이름은 몇 줄 아래에 시작하는 경우가 있습니다. 이때 첫 줄을 헤더로 잡으면 모든 열 이름이 잘못 인식됩니다.

열 이름처럼 보이는 행을 찾을 때는 여러 열에 서로 다른 짧은 텍스트가 반복적으로 배치되는지, 그 아래부터 데이터 형식이 일정해지는지 확인하세요.

따옴표 안 줄바꿈은 한 행 안에 있을 수 있습니다

메모나 주소 필드가 따옴표로 감싸져 있으면 그 안의 줄바꿈은 새 레코드가 아니라 한 셀의 내용일 수 있습니다. 단순히 줄 수로 레코드를 세면 실제 행 수와 달라질 수 있습니다.

그래서 중요한 CSV는 단순 문자열 치환보다 따옴표와 구분자를 이해하는 파서를 통해 처리하는 편이 안전합니다.

• 열이 한 칸에 몰림 → 구분자 확인
• 글자만 깨짐 → 인코딩 확인
• 열 이름이 이상함 → 실제 헤더 행 확인
• 행 수가 이상함 → 따옴표 안 줄바꿈 확인

이 가이드의 기준

이 글은 실제 파일 구조와 omtools 도구의 동작 방식을 기준으로 작성했습니다. 중요한 원본은 별도로 보관하고, 변환이나 정리 후에는 결과를 다시 열어 구조와 값이 유지됐는지 확인하는 것을 권장합니다.