CSV 검사기
불러온 파일:
스프레드시트에서는 잘 열리는 CSV도 데이터베이스 가져오기나 API 업로드에서는 실패할 수 있습니다. 이 검사기는 RFC 4180이 설명하는 방식으로 파일을 읽고, 구조상의 모든 문제를 줄 번호와 함께 보여 줍니다. 닫히지 않는 따옴표, 열 개수가 맞지 않는 행, 비어 있거나 중복된 머리글 이름, 파일 맨 앞의 바이트 순서 표시(BOM), 행 끝에 남은 구분 기호 등입니다. 텍스트를 붙여 넣거나 파일을 선택하고, 구분 기호를 고른 뒤(자동 감지도 가능) 보고서를 확인하세요.
CSV 파일을 검사하는 방법
-
1
CSV를 붙여 넣거나 업로드합니다
입력란에 텍스트를 붙여 넣거나 .csv, .tsv, .txt 파일을 선택하세요. 최대 1,000,000자까지의 파일을 사용할 수 있습니다.
-
2
구분 기호와 머리글 행을 선택합니다
구분 기호는 자동 감지로 두거나 쉼표, 세미콜론, 탭, 파이프 중에서 직접 지정하세요. 첫 번째 행이 열 이름인지도 선택합니다.
-
3
보고서를 읽습니다
각 문제는 줄 번호와 알기 쉬운 설명과 함께 오류 또는 경고로 표시됩니다. 보고서를 복사해 공유할 수 있습니다.
-
4
수정하고 다시 검사합니다
편집기에서 해당 줄을 고친 뒤 처음부터 다시 시작해 파일을 붙여 넣으세요. 보고서에 문제가 없다고 나올 때까지 반복하면 됩니다.
검사기가 확인하는 항목
RFC 4180은 CSV에서 표준에 가장 가까운 문서입니다. 레코드는 줄바꿈으로 구분하고, 구분 기호·따옴표·줄바꿈이 들어 있는 필드는 큰따옴표로 감싸야 하며, 따옴표로 감싼 필드 안의 따옴표는 두 번 써야 한다("")고 정하고 있습니다. 검사기는 이 규칙을 입력한 텍스트에 적용하고, 실무에서 중요한 검사를 몇 가지 더 합니다.
검사 항목과 보고 방식
| 검사 | 심각도 | 발생 조건 |
|---|---|---|
| 짝이 맞지 않는 따옴표 | 오류 | 따옴표로 감싼 필드가 열린 뒤 닫히기 전에 파일이 끝납니다. 표시되는 줄은 따옴표가 열린 줄입니다. |
| 따옴표 없는 필드 안의 따옴표 | 오류 | 따옴표로 시작하지 않는 필드 중간에 "가 있습니다. 예: 5" pipe |
| 닫는 따옴표 뒤의 텍스트 | 오류 | 닫는 따옴표 뒤에 구분 기호나 줄바꿈이 아닌 것이 따라옵니다. 예: "abc"def |
| 열 개수 | 오류 | 첫 번째 행보다 필드가 많거나 적은 행이 있습니다. |
| 비어 있는 머리글 이름 | 오류 | 머리글 행의 열 이름이 비어 있습니다. |
| 중복된 머리글 이름 | 오류 | 공백과 대소문자를 무시했을 때 두 열의 이름이 같습니다(Name과 name). |
| 바이트 순서 표시 | 경고 | 파일이 눈에 보이지 않는 문자 U+FEFF로 시작합니다. |
| 줄 끝 구분 기호 | 경고 | 행이 구분 기호로 끝나서 빈 열이 하나 더 생깁니다. |
| 빈 줄 | 경고 | 레코드 사이에 빈 줄이 있습니다. |
구분 기호
자동 모드는 비어 있지 않은 처음 25줄을 살펴보고, 같은 개수의 필드로 가장 자주 나누어지는 쉼표, 세미콜론, 탭, 파이프를 고릅니다. 따옴표로 감싼 필드 안의 구분 기호는 무시하므로 "Smith, J"가 두 열로 계산되지는 않습니다. 후보가 동률이면 쉼표가 우선합니다. 쉼표를 소수점으로 쓰는 지역에서는 세미콜론으로 구분한 파일이 흔하므로, 두 가지가 섞인 파일은 구분 기호를 직접 선택하세요.
줄 번호
줄 번호는 입력한 텍스트의 실제 줄을 1부터 센 것입니다. 줄바꿈이 들어 있는 따옴표 필드는 여러 실제 줄에 걸쳐 있습니다. 그 레코드의 문제는 레코드가 시작되는 줄에 보고됩니다.
CSV 오류의 흔한 원인
- 스프레드시트에서 내보낼 때 BOM이 붙고, 일부 가져오기 도구가 이를 첫 번째 열 이름의 일부로 읽습니다.
- 쉼표나 따옴표가 들어 있는 자유 입력 열을 내보내기 스크립트가 따옴표로 감싸지 않았습니다.
- 열 개수가 다른 파일을 합쳤습니다.
- 모든 값 뒤에 구분 기호를 붙여 쓰는 스크립트가 행 끝에 쉼표를 추가했습니다.
자주 묻는 질문
아니요. 행의 필드 개수가 첫 번째 행과 같다면 마지막의 빈 값은 평범한 데이터입니다. 검사기가 줄 끝 구분 기호를 경고하는 경우는 첫 번째 행보다 필드가 하나 더 늘어날 때, 또는 머리글 행 자체가 구분 기호로 끝날 때뿐입니다.
따옴표로 감싼 필드가 닫히지 않으면 그 뒤의 모든 내용이 해당 필드의 일부로 읽히기 때문에, 이후의 행을 믿을 수 있게 비교할 수 없습니다. 보고된 줄의 따옴표를 고친 뒤 다시 검사하면 그다음 문제를 볼 수 있습니다.
아니요. 파일의 구조만 검사합니다. 따옴표, 구분 기호, 열 개수, 머리글 이름, 바이트 순서 표시, 빈 줄이 대상이며, 값이 올바른 숫자나 날짜, 이메일인지는 확인하지 않습니다. 텍스트는 UTF-8로 읽습니다.
아니요. 붙여 넣은 텍스트나 선택한 파일은 사용 중인 브라우저에서 읽고 검사합니다. 저희 서버로 전송되지 않으며 페이지 링크에도 포함되지 않습니다. 단계 사이에는 브라우저의 현재 탭에만 보관되고, 처음부터 다시 시작하면 지워집니다. 링크에 나타나는 것은 구분 기호와 머리글 선택뿐입니다.
관련 도구
보색 찾기
어떤 입력에 대해서도 보색을 찾습니다. HSL 반대 색, 분할 보색 쌍, 그리고 접근성 있는 조합 제안을 반환합니다.
Webpack 설정 생성기
순수 JavaScript, React, Vue용 webpack 5 webpack.config.js를 만드세요. TypeScript, Babel, CSS 또는 Sass, 이미지, HtmlWebpackPlugin, 개발 서버, npm install 명령까지 함께 제공합니다.
색상 혼합기
두 HEX 색상을 2-20개의 균등한 색상 견본으로 섞습니다. 양 끝 색상을 포함해 각 중간 색상을 대문자 HEX 코드로 확인하세요.
PHP 포매터
간단한 PHP 코드에 줄바꿈과 2칸 또는 4칸 들여쓰기를 추가합니다. 결과를 반드시 검토하세요. PHP 파서나 PSR-12 적용 도구가 아닙니다.
텍스트 파일 인코딩 변환기
깨진 문자를 고치기 위해 텍스트를 UTF-8, UTF-16, Latin-1, Windows-1252 등 여러 인코딩 사이에서 변환하세요.
Protocol Buffers 디코더
hex, Base64, Base64URL, 텍스트 또는 파일의 Protobuf 와이어 형식 바이트를 브라우저에서 디코딩하고 정확한 필드 후보를 확인한 뒤 비공개 보고서로 내보냅니다.
이 도구는 다른 언어로도 제공됩니다
- Walidator CSV [PL]
- ตัวตรวจสอบ CSV [TH]
- Validador de CSV [ES]
- CSVバリデーター [JA]
- Trình kiểm tra CSV [VI]
- Validateur CSV [FR]
- Validador de CSV [PT]
- CSV-validerare [SV]
- مدقق CSV [AR]
- CSV-Validator [DE]
- Validator CSV [ID]
- CSV-validator [NL]
- CSV Validator [EN]
- Validatore CSV [IT]
- Валидатор CSV [RU]
- CSV Doğrulayıcı [TR]
- CSV 校验器 [ZH]