CSV 파일 점검 도구: 열 수·식별자·따옴표 확인

파일을 선택하거나 텍스트를 붙여넣으세요.

파일은 열리는데 값이 바뀌는 일을 먼저 찾기

CSV가 다운로드된다는 사실과 업무에 그대로 쓸 수 있다는 사실은 다릅니다. 한 행의 구분자가 잘못 들어가면 수량이 옆 열로 이동하고, 스프레드시트가 ID를 숫자로 읽으면 00123이 123으로 바뀔 수 있습니다. 이 도구는 원본 문자열을 숫자로 변환하지 않고 구조와 주의할 값을 표시합니다. 수정된 CSV를 만들거나 원본을 덮어쓰는 기능은 없습니다.

파일을 읽었다는 안내가 나오면 ‘검사하기’를 누르고 미리보기와 검사 결과를 확인하세요. 읽는 동안 검사 버튼은 잠시 비활성화되며 ‘입력 지우기’로 읽기를 취소할 수 있습니다. 쉼표 파일이 한 열로 보인다면 파일에 실제 쓰인 구분자가 세미콜론이나 탭인지 확인해 선택을 바꿉니다. 내용에 한글이 있어도 UTF-8이면 읽을 수 있습니다. CP949 파일을 임의로 UTF-8이라고 해석하지 않으며, 읽을 수 없으면 검사를 중단합니다.

첫 샘플에서 대조할 세 가지

‘설명용 샘플 넣기’를 누르면 열 이름 3개와 데이터 3레코드가 들어갑니다. 첫 번째 ID는 00123, 두 번째는 00007, 세 번째는 12345678901234567입니다. 검사 결과는 첫 행 3열·데이터 3레코드, 앞자리 0 주의 2개, 16자리 이상 숫자 문자열 주의 1개가 되어야 합니다. 수량 80·5·38의 업무상 타당성은 이 검사로 판단하지 않습니다.

첫 데이터 행 끝에 쉼표와 값을 하나 더 붙이면 해당 레코드가 4열이라는 경고가 나옵니다. 이름 안에 쉼표를 넣을 때는 큰따옴표로 해당 필드를 묶습니다. 이름 안의 큰따옴표는 두 번 이어 적고, 따옴표 안의 줄바꿈은 한 필드 내용으로 유지합니다. 따라서 화면의 줄 수와 CSV 레코드 수가 다를 수 있습니다.

표시 결과별 다음 작업

검사 기록과 SHA-256의 의미

검사 후 TXT 기록을 내려받으면 시각, 구분자, 행·열 개수, 경고 위치, SHA-256을 남길 수 있습니다. 원문 셀 내용과 파일 이름은 TXT에 넣지 않습니다. 선택한 파일은 원본 바이트의 해시를 계산하고, 붙여넣기는 현재 입력 텍스트를 UTF-8로 바꾼 바이트의 해시를 계산합니다. 두 경로는 줄바꿈이나 BOM 때문에 서로 다른 해시가 나올 수 있습니다.

같은 해시는 같은 바이트인지 대조하는 수단입니다. 잘못된 원본을 그대로 복사해도 해시는 같으므로 정확한 수량, 예약 충돌, 권한, 법적 보관 의무까지 증명하지는 않습니다. 원본 사본을 유지하고 실제 프로그램에 가져온 결과를 별도로 대조해야 합니다.

배포 전 확인한 범위

2026년 10월 10일, 파서의 정상·오류·상한 경계 입력 26종과 사이트에서 배포하는 CSV 38개의 행별 열 수를 동일 검사 코드로 확인했습니다. 26종에는 따옴표 안 쉼표·CRLF, 연속 큰따옴표, UTF-8 BOM, 끝의 개행과 빈 필드, 탭·세미콜론, 열 수 불일치, 중복 열 이름, 미완성 따옴표, 식별자 보존, 수식 후보, HTML 문자열, 레코드·열·전체 셀 수 상한의 통과·거절이 포함됩니다.

이 결과는 CSV 구조와 문자열 처리 범위의 확인입니다. 각 양식을 실제 사업장에 도입한 성과나 모든 Excel·구글시트 버전의 가져오기 결과를 시험했다는 뜻은 아닙니다. 화면 미리보기는 처음 5레코드·20열, 긴 값은 160자까지 보여주며 원본 값은 잘라 저장하지 않습니다. 화면 경고는 처음 50개, TXT 기록에는 전체 경고를 포함합니다.

CSV 파서와 배포 파일 검사 목록 TXT 내려받기에서 입력별 결과와 검사 범위를 확인할 수 있습니다.

형식 설명과 다음 작업

RFC 4180 §2는 쉼표·큰따옴표·레코드 형식을 설명하는 자료입니다. 이 도구는 UTF-8, LF·CRLF·CR 줄바꿈과 명시적으로 선택한 세미콜론·탭도 처리합니다. CSV 형식은 가져오기 프로그램의 숫자 변환을 막는 자료형 지정 기능이 아닙니다.

• 앞자리 0이 사라지는 이유와 가져오기 후 문자열 대조
• 배포 전 구조·열림·보안 확인 절차
• 원본·사본의 해시와 업무 사용 가능성 구분
• 업무표와 설명용 샘플 모음